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TERMS AND CONDITIONS OF SALE AND LICENSE OF TANDY COMPUTER EQUIPMENT AND SOFTWARE PURCHASED 
FROM RADIO SHACK COMPANY-OWNED COMPUTER CENTERS, RETAIL STORES AND RADIO SHACK FRANCHISEES OR 
DEALERS AT THEIR AUTHORIZED LOCATIONS 


USA LIMITED WARRANTY 
CUSTOMER OBLIGATIONS 


A. CUSTOMER assumes full responsibility that this computer hardware purchased (ihe ‘“Equipment’’}, and any copies of software included with the 
Equipment or licensed separately (the ‘‘Software’’) meets the specifications, capacity, capabilities, versatility, and other requirements of CUSTOMER. 

B. CUSTOMER assumes full responsibility for the condition and effectiveness of the operating environment in which the Equipment and Software are to 
function, and for its installation. 


LIMITED WARRANTIES AND CONDITIONS OF SALE 


A, For a period of ninety (90) calendar days from the date of the Radio Shack sales document received upon purchase of the Equipment. RADIO SHACK 
warrants to the original CUSTOMER that the Equipment and the medium upon which the Software ts stored is free from manufacturing defects. This 
warranty is only applicable to purchases of Tandy Equipment by the original customer from Radio Shack company-owned computer centers, 
retail stores, and Radio Shack franchisees and dealers at their authorized locations. The warranty Is void If the Equipment or Software has been 
subjected to improper or abnormal use. If a manufacturing defect is discovered during the stated warranty period, the defective Equipment must be 
returned to a Radio Shack Computer Center, a Radio Shack retail store, a participating Radio Shack franchisee or a participating Radio Shack dealer 
for repair, along with a copy of the sales document or lease agreement. The original CUSTOMER'S sole and exclusive remedy in the event of a defect 
is limited to the correction of the defect by repair, replacement, or refund of the purchase price, at RADIO SHACK’S election and sole expense. 
RADIO SHACK has no obligation to replace or repair expendable items. 

B. RADIO SHACK makes no warranty as to the design, capability, capacity, or suitability for use of the Software, except as provided in this paragraph. 
Software is licensed on an "AS IS” basis, without warranty. The original CUSTOMER'S exclusive remedy, in the event of a Software manufacturing 
defect, is tts repair or replacement within thirty (30) calendar days of the date of the Radio Shack sales document received upon license of the 
Software. The defective Software shall be returned to a Radio Shack Computer Center, a Radio Shack retail store, a participating Radio Shack 
iranchisee or Radio Shack dealer along with the sales document. 

C. Except as provided herein no employee, agent, franchisee, dealer or other person is authorized to give any warranties of any nature on behalf of 
RADIO SHACK. 

D. EXCEPT AS PROVIDED HEREIN, RADIO SHACK MAKES NO EXPRESS WARRANTIES, AND ANY IMPLIED WARRANTY OF MERCHANTABILITY OR 
FITNESS FOR A PARTICULAR PURPOSE IS LIMITED IN ITS DURATION TO THE DURATION OF THE WRITTEN LIMITED WARRANTIES SET FORTH 
HEREIN. 

E. Some states do not allow limitations on how Jong an implied warranty lasts, so the above limitation(s) may not apply to CUSTOMER. 


LIMITATION OF LIABILITY 


A. EXCEPT AS PROVIDED HEREIN, RADIO SHACK SHALL HAVE NO LIABILITY OR RESPONSIBILITY TO CUSTOMER OR ANY OTHER PERSON OR 
ENTITY WITH RESPECT TO ANY LIABILITY, LOSS OR DAMAGE CAUSED OR ALLEGED TO BE CAUSED DIRECTLY OR INDIRECTLY BY 
“EQUIPMENT” OR “SOFTWARE” SOLD, LEASED, LICENSED OR FURNISHED BY RADIO SHACK, INCLUDING, BUT NOT LIMITED TO, ANY 
INTERRUPTION OF SERVICE, LOSS OF BUSINESS OR ANTICIPATORY PROFITS OR CONSEQUENTIAL DAMAGES RESULTING FROM THE USE OR 
OPERATION OF THE “EQUIPMENT” OR “SOFTWARE.” IN NO EVENT SHALL RADIO SHACK BE LIABLE FOR LOSS OF PROFITS, OR ANY 
INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY BREACH OF THIS WARRANTY OR IN ANY MANNER ARISING OUT OF 
OR CONNECTED WITH THE SALE, LEASE, LICENSE, USE OR ANTICIPATED USE OF THE “EQUIPMENT” OR “SOFTWARE.” 

NOTWITHSTANDING THE ABOVE LIMITATIONS AND WARRANTIES, RADIO SHACK’S LIABILITY HEREUNDER FOR DAMAGES INCURRED BY 
CUSTOMER OR OTHERS SHALL NOT EXCEED THE AMOUNT PAID BY CUSTOMER FOR THE PARTICULAR “EQUIPMENT” OR “SOFTWARE” 
INVOLVED. 

B. RADIO SHACK shall not be liable for any damages caused by delay in delivering or furnishing Equipment and/or Software. 

C. No action arising out of any claimed breach of this Warranty or transactions under this Warranty may be brought more than two (2) years after the 
cause of action has accrued or more than four (4) years after ihe date of the Radio Shack sales document for the Equipment or Software, whichever 
first occurs. 

D. Some states do not allow the limitation or exclusion of incidental or consequential damages, so the above |imitation(s) or exclusion(s) may not apply 
to CUSTOMER. 


SOFTWARE LICENSE 


RADIO SHACK grants to CUSTOMER a non-exclusive, paid-up license to use the TANDY Software on one computer, subject to the following provisions: 
Except as otherwise provided in this Software License, applicable copyright jaws shall apply to the Software. 

B. Title to the medium on which the Software is recorded (cassette and/or diskette) or stored (ROM) is transferred to CUSTOMER, but not title to the 
Software, 

C. CUSTOMER may use Software on a multiuser or network system only if either, the Software is expressly labeled to be for use on a multiuser or 
network system, or one copy of this software is purchased for each node or terminal on which Software is to be used simultaneously. 

D. CUSTOMER shall not use, make, manufacture, or reproduce copies of Software except for use on one computer and as is specifically provided in 
this Software License. Customer is expressly prohibited from disassembling the Software. 

E. © CUSTOMER is permitted to make additional copies of the Software only for backup or archival purposes or if additional coples are required in the 
operation of one computer with the Software, but only to the extent the Software allows a backup copy to be made. However, for TRSDOS Software, 
CUSTOMER is permitted to make a |Imited number of additional copies for CUSTOMER'S own use. 

F. CUSTOMER may resell or distribute unmodified copies of the Software provided CUSTOMER has purchased one copy of the Software for each one 
sold or distributed. The provisions of this Software License shall also be applicable to third parties receiving copies of the Sofiware from 
CUSTOMER. 

G. All copyright notices shall be retained on all copies of the Software. 


APPLICABILITY OF WARRANTY 


A. The terms and conditions of this Warranty are applicable as between RADIO SHACK and CUSTOMER to either a sale of the Equipment and/or 
Software License to CUSTOMER or to a transaction whereby Radio Shack sells or conveys such Equipment to a third party for lease to CUSTOMER. 

B. The limitations of liability and Warranty provisions herein shall inure to the benefit of RADIO SHACK, the author, owner and or licensor of the 
Software and any manufacturer of the Equipment sold by Radio Shack. 


STATE LAW RIGHTS 


The warranties granted herein give the original CUSTOMER specific legal rights, and the original CUSTOMER may have other rights which vary from 
state to state. 
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To the System Administrator: 


As we prepared this guide, we tried to keep in mind your needs. We assume that 
you are relatively unfamiliar with XENIX, and perhaps have little computer 
experience, but are eager to establish an office system that uses XENIX as a base. 


XENIX is a sophisticated, complex tool, but you don’t have to know all about it or 
understand it compleiely to use it to great advantage. Therefore, in this guide we 
have frequently told you the hows and not the whys. We felt it was important to 
give you usable information quickly and simply. 


When you feel comfortable using the procedures described here, you may want to 
learn more about XENIX. The following books are excellent sources and can be 
obtained at most bookstores with a computer science section: 


Exploring the UNIX™ System, by Stephen G. Kochan and Patrick H. Wood. 
Hasbrouck Heights, NJ: Hayden Book Company, 1984. 


A User Guide to the UNIX™ System, by Rebecca Thomas and Jean Yates. 
Berkeley, CA: Osborne/McGraw-Hill, 1982. 


The Tandy XENIX system is in 2 parts — the Core System and the Development 
System: The Core System comes with your computer; if you want the Development 
System, you must purchase it separately. It contains programming tools and text- 
processing tools and is primarily for those who wish to use these advanced 
features. 


We believe that as you increase your XENIX knowledge and skills, you will 
become intrigued with the possibilities for using it in your office. We welcome 
your comments and suggestions concerning XENIX and these guides. Please send 
them to: 

XENIX Editor 

Technical Publications 

900 Two Tandy Center 

Fort Worth, TX 76102 


Although we cannot acknowledge or respond to individual letters, we assure you 
that your communications will be taken into consideration as we prepare future 
versions of XENIX and later editions of these guides. 


If you have specific questions or problems that require immediate attention, please 
contact our Computer Customer Service Department. The representatives in this 
department are specially trained to help you. 
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introduction 


This manual is for you, the System Administrator of a XENIX system. It contains the 
information you need to install, maintain, and run your XENIX system. 


As System Administrator, you have important responsibilities. These include the 
following: 


- Installing XENIX 

- Installing applications programs 

‘ Creating users 

- Making backups 

- Maintaining the file system 

+ Setting up terminals 
XENIX provides you with powerful tools, and you can use them to create and 
maintain an extremely efficient data processing center for your business. This 
manual contains step-by-step instructions for completing all routine tasks. You can 
use it, The User’s Guide to XENIX, and the XENIX Quick Reference Guide to 
Commands to establish and maintain a fully functioning multiuser, multitasking 
environment. 


A glossary and an index are in the back of this manual. You can use these devices 
to locate specific information quickly. 


XENIX and your computer keyboard 


XENIX is a lowercase system. In general, it recognizes lowercase alphabetic 
characters. Be sure to type lowercase characters when entering commands. If you 
are typing text to be printed on the line printer, you can use uppercase, lowercase, 
or a combination. 


Some of the keys on your keyboard have a special meaning to XENIX. You 
frequently use control key sequences in XENIX. When typing a control sequence, 
press (CTRL |, hold it down, and press the second key. Then, release both keys 
simultaneously. 


The following are some useful control sequences: 


CTRL | d Logs you out of XENIX and ends input for some 
commands. 

CTRL | q Starts scrolling (moves text up and off the screen) after 
you have stopped it. 

CTRL | s Halts scrolling (stops text from moving up and off the 
screen). 

CTRL | 6 Produces the tilde (°) on the screen. 

CTRL! 9 Produces a backslash (\) on the screen. 

CTRL | 0 Produces a vertical line, or pipe (|), on the screen. 

CTRL | ’ Produces a backwards quotation mark ©) on the screen. 

q 


Some important keys: 


Interrupts a command or program and returns you to your 
prompt. 

End every command in XENIX by pressing [ENTER ]. If a 
screen message instructs you to type or press (RETURN ], 
press [ENTER]. 


XENIX commands 


Commands in this guide are in boldface. Type boldface text exactly as it appears. 
Text in italics indicates a variable; you substitute something for the italicized text. 
For example, in the command cat filename, you substitute the actual filename for 
the word filename. 


about your equipment 


To run XENIX you must have: 


* A Tandy computer with 512K memory 
- A hard disk 
- One floppy drive 


You can use the following optional equipment: 


- A Tandy printer 

- A maximum of 5 Tandy data terminals (more than 2 terminals requires the 
RS-232 card) 

+ Multiple floppy drives 

+ Multiple hard drives 

- Disk cartridge system 

- Modem(s) 

- Additional memory 

* High Resolution Graphics 
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installing XENIX 
on your hard disk 


XENIX is supplied on 4 floppy diskettes — Boot Disk, Install 1, Install 2, and File 
Maintenance. (An Upgrade floppy diskette is also included in upgrade releases.) 
Before you can use XENIX, you must transfer the data on these diskettes to the 
hard disk. 


Normally, you transfer XENIX to hard disk only once. After you have done so, 
however, keep the diskettes in a safe place in case you need to reinstall XENIX 
because of some problem with the hard disk. If you make a mistake during 
installation, press the reset switch and repeat the process from the beginning. | - 


Before you begin, look at the Media Error Map that is attached to your hard disk. 
Copy the information from the TRACK and HEAD columns so that when asked to 
do so later you can enter it. 


Important Note to Disk Cartridge System Users: You must turn on the disk 
cartridge- system before the hard disk and the computer. Do not run XENIX with 
the disk cartridge system attached but not turned on. This can cause XENIX to 
crash and could result in data loss. Also, be sure that the disk cartridge system is 
the last thing turned off. (You can connect the entire system, including the disk 
cartridge system, to a power strip and turn it all on at once.) 


formatting your hard disk 


1. If you have a disk cartridge system connected, turn it on first. Then turn on 
the hard disk followed by your computer. Do not write-protect the hard disk. 


Note: Before formatting your hard disk, you should turn it on and let it warm 
up for 30 minutes. 


2. Press | BREAK } and | REPEAT | simultaneously until the screen shows: 


INSERT DISKETTE 


3. Place Boot Disk in floppy Drive @. After the screen shows the copyright 
notice, the following prompt appears: 


Xenix Boot? 


4. Type diskutil | ENTER |, and the screen shows this message: 


Diskutil: format or copy floppy diskettes 
format hard disks 
format or copy disk cartridges 


At any time you may type <break> or press RESET to 
abort the procedure. The backspace key may be used to 
correct single characters of your input. End each 
line you type by typing <enter>. 


Diskutil: Hard, floppy, or cartridge Ch, f, or c)? 
11 
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10. 


Type h | ENTER | and the screen shows: 

Hard disk unit number (€6..3)7 
Type @ | ENTER | to indicate that you are formatting your primary, or first, hard 
disk. The screen may show: 


Destructive or Non-destructive format Cd or n)? 


Type d ( ENTER]. 


You must choose “destructive format.” This assures that XENIX will write and 
verify the tracks on your hard disk tn the proper manner. 


You choose “non-destructive format” only when you are upgrading from a 
previous version of XENIX or when you are reformatting and your hard disk 
contains data that you want to save. 

The screen now shows: 


Consult your computer manual, or the instruction sheet 
that accompanies your hard disk, for the answers to 
the following two questions: 


How many cylinders (tracks)? 
Answer this question and the one following with the numbers given in the 


manual. For example, if you have a 15-megabyte hard disk, there are 306 
cylinders and 6 heads. After you answer both questions, the screen shows: 


Desired interleave factor C<ENTER> for default)? 


Press | ENTER |. 


Now the screen shows the following message: 
Find the MEDIA ERROR MAP and type in the list of TRACK 


and HEAD numbers as follows. For instance, if the 
list shows 
TRACK HEAD BYTE COUNT LENGTH 
133 g 91333 g2 
174 63 99826 as 


you should type 
133,8 <enter>? 
174,3 <enter> 
done <enter>? 
If the list is empty, just type "done". 
At any time, you may type <break>? to abort. 


enter next pair or "done": 


After you type done | ENTER |, the following appears on your screen: 
Full, partial, or no verify Cf,p,n) ? 


Type f (ENTER |]. Always do a full verify when first formatting a hard disk. 


Note: If you are reformatting to add an entry to the Media Error Map, be 
sure to enter all the bad tracks found by diskutil during previous formattings. 
You may use partial verify in this case to speed formatting, but we 
recommend that you use full verify. Partial verify takes about half the time of 
full verify. 


When the verify is complete, your screen shows: 


About to format hard disk drive Í. 
This will take about xx minutes. 


Type <enter>? to proceed or <break> to abort: 


oa 
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On your screen, xx is the number of minutes. The time depends on the size 
of your hard disk. 
Press | ENTER |. When the formatting is complete, the screen shows: 


Hard disk successfully formatted. 

Drive parameters and MEDIA ERROR MAP successfully 
written. 

Your hard disk is ready for the XENIX initialization. 


Diskutil: Hard, floppy, or cartridge Ch, f or c)? 


Press the reset switch and then press BREAK and | REPEAT | E 
until the following prompt appears on the screen: 


Xenix Boot> 


initializing your hard disk 


Follow the steps below to initialize your hard disk. 


I 


At the prompt, press | ENTER | and the screen shows: 


System loaded , 
Change root. disk if desired; 3 
type <enter> to proceed or ¢break> to abort 


Press | ENTER |. After a while, the following question appears on your screen: 


Do you wish to initialize your hard disk? 


Since you wish to do so, type y | ENTER |. Now the program asks: 
Has your hard disk been formatted with diskutil? 


Type y | ENTER |. The screen shows the following message: 
Is this a Model 11? [y or ni 


If you are installing XENIX on a Model II, type y [ENTER |. Otherwise, type n 
| ENTER |. The screen shows: 


Do you want the standard size swap area? Ly or ni 


Type y [ENTER] N T? CG 


Note: The swap area is the space XENIX uses to temporarily store 
information on running programs. The standard size is 2057 blocks. In most 
cases, you can use the standard size. If you want to change the size of this 
area, type n in response to the above question. XENIX then asks you 
a series of questions. Respond when you are prompted to do so. 


Now, the screen shows that initialization is proceeding. This takes a few 
minutes. When initialization is complete, the screen shows: 


Please reboot from the hard disk after the system 
shuts itself down. 


Halting system. . 
** Normal System Shutdown # * 


[Z8 Control System Halted] 
Now, remove the Boot Disk from Drive @. 


Note: If, for some reason, you are reinstalling XENIX, the system may tell you 
that your hard disk contains data and ask whether you wish to “overwrite.” 


Type y to finish initializing. 
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installing the XENIX core 


Now you are ready to copy the contents of the Install disks onto your hard disk. In 
this phase you boot—startup—from your hard disk. To do so, press the reset 
switch, but do not press | BREAK |. The screen shows: 
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Xenix Boot> 


Press [ ENTER |, and follow the steps outlined below to complete your installation of 
XENIX. 


Í. 


XENIX sometimes refers to a floppy diskette as a “volume.” When it does so, 
simply follow the instructions as they pertain to the floppy diskette. When you 
press | ENTER | at the boot prompt above, the screen shows: 


For each floppy in the distribution set, insert the 
floppy into Drive @ and press <Enter> or type y. Type 
n after the last floppy is installed. 


If you ever see the message “tar: please mount new 
volume," insert the next floppy into Drive @ and press 
<ENTER>. Do not interrupt the installation of the 
distribution at this point. 


First Floppy? [y,n] 
Insert Install 1 and type y [ENTER |. When the data is transferred to your hard 
disk, the screen shows: 

Next Floppy? Cy,n] 
Remove Install 1 and insert Install 2. Type y | ENTER |. When the data on this 
diskette is transferred to your hard disk, the screen again shows: 

Next Floppy? [y,n] 


Remove the Install disk. If there are more Install diskettes, continue to insert 
them into the drive until all have been transferred to hard disk. Then type n 


ENTER |. The screen shows: 


Setting up directories and permissions. 


XENIX then asks for information concerning your location and timezone. 
Answer these prompts appropriately for your area. 


Next, the screen shows: 


Installation complete. 


Type CONTROL-d to proceed with normal startup, Cor 
Give root password for system maintenance): 


Type | CTRL| d. Your hard disk now contains the complete XENIX operating 
system. The last instruction above is the normal boot you see whenever you 


start the system. The next chapter explains how to log in and log out and 
how to shut down the system. 
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accessing XENIX 


Now that you have installed XEN!X on your hard disk, XENIX boots when you 
power up the hard disk and the computer. At this point in the installation, 
however, XENIX is booted, and you are ready to enter the date and time and log 
in. See the section at the end of this chapter for routine startup procedures when 
your system has been totally shut down. 


XENIX asks you to enter the date and time in the following format: 
yymmedhhmm 


yy is the year; mm is the month; dd is the day; hh is the hour (in 24-hour units); 
and mm is the minutes. For example, to enter 2:05 P.M., October 7, 1984, type: 


8410071405 


You may press and not type the date and time at all. We strongly 
recommend, however, that you always type the full date and time. XENIX stores 
this information and lets you automatically access it in applications programs. The 
date is also important in determining when files were created or changed. If you 
press and do not type a date, XENIX uses the date it displayed as the 
current date. 


Now type the current date and time and you are ready to log in. 


logging in 


Logging in is simply identifying yourself to XENIX. As the System Administrator, 
you may log in as “root” and as a user. And, as the System Administrator of a 
multiuser system, you are the only person who can log in as root. For now, we 
will show you how to log in as root, how to assign yourself a root password, how 
to log out, and how to shut down the system. In the next chapter, we will show 
you how to log in as a user and how to create other users. 


You must log in as root to perform the following operations: install applications 
programs, make periodic and daily backups of the system, restore a hard disk, 
check the files. 


1. After you enter the date and time, the screen shows: 
login: 
Type root | ENTER |. 


2. The root prompt (#) now appears on your screen. Type: 


passwd | ENTER 
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The screen shows: te 


Changing password for root 

Enter new password Cminimum of 5 characters) 

Please use a combination of upper and lowercase 
letters and numbers. 

New password: 


Choose your password carefully. It can contain a minimum of 5 characters 
and can consist of any characters on the keyboard except [ BACKSPACE J, 
[BREAK], and [ENTER |. Mix upper- and lowercase characters and numbers. Be 
sure that it is not something easily guessed or something that you might not 
remember. 


Warning: Do not forget your root password. If you do forget, you must 
reinstall the XENIX system from the distribution floppy diskettes. 


3. Type your password and then press | ENTER |. Notice that the screen does not 
display the password. 


4. Now the screen shows: 
Re-enter new password: 


5. Type your password again and press (ENTER |. XENIX records your password 
in a file called /etc/passwd. The screen shows the root prompt. 


logging out 


To log out, or sign off, at the root prompt type: 


[CTRL] d = 


XENIX returns to the login: prompt. In a multiuser environment, the system is now 
ready for a new user to log in. 


At this point, you can shut down the system and turn off your computer, hard disk, 
and peripherals. We recommend, however, that you leave your system up and 
running 24 hours a day. Password protection makes your files secure, and the 
continuing successful operation of your hardware is more assured if the system is 
not turned on and off with any frequency. The cost of power to keep it running is 
offset by fewer hardware repair bills and less down time. 


shutting down the system 
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Although we recommend that you not shut down the system on a regular basis, the 
routine for shutting down is given below. 


Caution: If you are in a multiuser environment, that is, if other users are logged in 
on terminals, you should warn users before shutting down the system. To do so, at 
the root prompt type shutdown [ENTER |. XENIX asks you how many minutes until 
shutdown and asks the reason for the shutdown. Then XENIX sends a message to 
that effect to all users. XENIX then shuts down at the specified time. 


If the system is not shut down properly, the next time you boot XENIX you may see 

a message that the system was not shut down properly and needs cleaning. XENIX 

will ask if you wish to proceed with cleaning. Always respond ”yes” to this 

question. | a 


1. The screen now shows the login: prompt. Type root and then type 
your password. 


ap 


Q 


a 


4. 
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When the root prompt appears, type: 
shutdown | ENTER 


The screen shows: 
Minutes until shutdown? (C8-30): 


Type a number from Ø to 30, and press [ENTER]. 


Next, the screen shows: 


Shutdown and Halt, Reboot, or go Single-user? Ch, r, 
or 5): 


Type h 


Now, the screen shows: 


Shutdown reason? 


Whatever you type at this prompt will be displayed with the warning 
message. 


Note: If you want extra protection for your hard disk, before typing the above 
command type /etc/park —on [ENTER |. The read/write head of the hard drive 
will move to the last cylinder of the hard disk when the system shuts down. 
Using park protects your hard disk from accidentally being damaged by a 
hard knock or a power surge. When you start up XENIX for the first time, 
park is off. This means that the read/write head is not moved before 
shutdown. If park is on, you may need to press the reset switch twice to 
reboot XENIX. 


The following appears on your screen: 
** Normal System Shutdown ** 


[280 Control System Halted] 


Now turn off your computer and then turn off your hard disk. 


starting up after shutdown 


Your entire system is now turned off. If you have a disk cartridge system connected, 
turn it on. Then turn on the hard disk, followed by the computer. 


1. 


The following appears on your screen: 

Xenix Boot? 
Press | ENTER |. After XENIX boots, the screen displays information about 
availability of system space. Then the following instructions appear: 


Type CONTROL-d to proceed with normal startup, 
Cor give root password for system maintenance): 


Type | CTRL | d. Enter the date and time, and then log in as root and enter your 
password. The root prompt appears on your screen. 


Note: Be sure to wait until the password prompt appears to type your 
password. If you type it ahead of the prompt, the screen shows your 
password. 


You are now ready to create users. 
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If you prefer, you can press at the Xenix Boot> prompt, and the system will 
go directly to multiuser mode. This method should not be used if XENIX has not 
been running recently, as the date and time will be set to the time when XENIX 
went down. 


Set the date and time by logging in as root and typing asktime. Setting the time 
more than a few minutes ahead should be done in maintenance mode. 
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adding users 


As the System Administrator you are now able to log in as root, but you also need 
to be able to log in as a user. You should log in as root only when you need to 
perform tasks that only root has the power to do; otherwise, log in as a user. 


In some situations, you may need to let someone besides yourself have access to 
your root password. Anyone who knows this password can also log in as root and 
use root’s full powers. Everyone with access to the root password needs to be 
aware that making even a minor mistake in the root mode can cause major 
problems with the system. Therefore, log in as root only when it is absolutely 
necessary. 


One of the special powers available only to root is that of creating users. You do 
this with a program called mkuser. In a multiuser environment you will need to 
create several users. You add users to the system one at a time. First, however, 
create a user directory for yourself. 


creating a user 


1. At the root prompt, type: 
mkuser | ENTER 


The screen shows: 
Newuser 
Add a user to the system 


Do you require detailed instructions? Cy/n): 


2. Because this is your first time to set up a user, type y [ENTER |, and XENIX 
takes you through the mkuser program step by step. The screen now shows: 


This program will guide you through the steps required 
to add a new XENIX user to the system. It will ask for 
the following information. If you don’t know any of 
these items, press BREAK and come back later. 


login name, comment, group, shell, password 


Generally the program will tell you what it wants 
Csuch as the login name), describe the acceptable 
responses, and prompt you for an answer. 


Nothing is updated on the system until you confirm 
everything is correct. The program will ask you this 
after you have entered all the information. At any 
time until then you can press BREAK to exit without 
adding the user. You can also answer `g’ or ‘quit’ to 
any question to achieve the same effect. 


Press RETURN to start: 
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Press | ENTER |. 


Note: Whenever XENIX refers to | RETURN | or asks you to press | RETURN |, 
always substitute | ENTER |. 


Now the screen shows: 


Please give the new user’s login name. This must be 
at least 3 characters long, begin with a lower case 
letter, and contain only lower case letters and 
digits. It must also not already exist in this system 


Enter new user's login name: 


Because you are setting up the first user on your system, the login name can 
be anything you choose. It is usually convenient to use a form of the user’s 
real name. For example, if the user’s name is Ross Pratt, the login name can 
be ross, rossp, rpratt, and so on. 


Type name | ENTER |. The screen shows: 


Users are usually assigned to the default user group. 
This is the group name "group", number 58. If you 
want to assign the mew user to some other group, you 
can either specify an existing group, or a new group 
to be created. 


Do you want to use the default group? (y/n): 
Type y [ENTER]. The screen shows: 


Please give the initial password for this user. 


For maximum security a minimum number of characters is 
required. Up to eight characters are significant. You 
may use any characters except RETURN and LINE FEED. 


Note that the password entry will NOT echo on the 
screen. This is just to provide an extra degree of 
security. 


If you don’t want a password for this user, just type 
RETURN. 


Please enter at least 5 characters for the password. 
Enter password: 


Type the password you have chosen and press | ENTER]. 


Note: As you did when you selected your root password, choose a password 
that is not easily guessed and that you can easily remember. Forgetting a user 
password is not critical, however. If a user password is forgotten, the System 
Administrator must install a new password for the user. The user can then 
change the password to a preferred one. Instructions for doing so are below. 


The screen now shows: 
Re-enter for check: 
Type your password again and press | ENTER |. 


The screen shows: 
Please specify the type of shell €command interpreter) 


this user requires. You can type 1, 2, or 3 as 
follows: 
1 Standard (Bourne) Shell. 


2 Visual Shell. 
3 C Shell. 


ENTER Shell type (1,2 or 3) and press ENTER: 


i a 
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Select 1 or 3 and press | ENTER |. 


If you specify Option 2, the user will be unable to log in if the XENIX 
Development System ts not installed. 
10. The screen now shows: 


There is an optional field in the password file where 
you can put a comment, such as the user’s fullname, 
phone #, room #, etc. If you wish to leave this 
blank, just type RETURN. The comment should be short 
Cup to 2@ characters). 


Please Enter Comment: > 


a a l ED g gees ee ee ee ee ee ee gee ee eee 


11. Press | ENTER | and the screen shows: 


These are the details you have entered for the new 
user. Please check they are correct. 


User name is: name, user id i5 xxx. 

Group name is "group", group number is 5@. 
Comment Field is: 

Shell is "/bin/sh" 


Do you want to change anything? (y/n): 


Type n CENTER}. 
12. The screen shows: 


Password file updated 

Group file updated 

Home directory /usr/name created 
/usr/name/.profile created 

User name added to this system 


Do you want to add another user? (y/n); 


13. Type n [ENTER |, and the screen shows the root prompt. 


Now that you have worked through the mkuser program following the detailed 
instructions, you can shorten the procedure by simply responding to a series of 
prompts that appear on your screen. 


1. At the root prompt, type: 
mkuser | ENTER 


2. The screen shows: 
Newuser 
Add a user to the system 
Do you require detailed instructions? Cy/n): 
3. Typen and XENIX asks for the login name. Type name [ENTER |. The 
screen shows: 
Do you want to use the default group?Cy/n): 


4. Type y [ENTER |. The screen shows: 


Please enter at least 5 characters for the password 
Enter password 


5. Type your password and press | ENTER |. The screen shows: — 


Re-enter for check: 


21 


3/adding users 


10. 


Type your password again and press | ENTER }. The screen shows: 
ENTER Shell type (1,2 or 3) and press ENTER: 


Type 1 [ENTER], and the screen shows: 


Please Enter Comment: >? 


me cs ce cee es ee i ee es es es ee ee es ees a 


Press | ENTER |. The screen shows: 


User name is "name", user id iS XXX, 

Group name is “group”, group number is 58, 
Comment Field is: 

Shell is "/bin/sh" 


Do you want to change anything? Cy/n): 


Type n | ENTER |. The screen shows: 


Password file updated 

Group file updated 

Home directory /user/name created 
/usr/name/.profile created 

User name added to this system 


Do you want to add another user? (y/n): 


Type n | ENTER |, and the root prompt appears. 


changing a user password 
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A user who wishes to do so may change his or her password when logged in. 
However, only you, as System Administrator, may create a new password if a user 
forgets his or her password. 


creating a new user password 


l 


At the root prompt, type: 
passwd fogin name | ENTER 


The screen shows: 


Enter new password Cminimum of 5 characters) 
Please use a combination of upper and lowercase 
letters and numbers. 

New password: 


Type the new password and press | ENTER |. The screen shows: 
Re-enter new password: 


Type the new password again and press | ENTER]. 


The screen shows the root prompt. Now the new password is substituted for 
the old, forgotten one. 


changing a user password 


1 


2: 


At the user prompt ($), type: 
passwd 


The screen shows: 


Changing password for user 
Old password: 


3/adding users 


Type your password and press [ENTER ]. The screen shows: 


Enter new password (minimum of 5 characters) 
Please use a combination of upper and lowercase 
letters and numbers 

New password: 


Type your new password and press [ENTER]. The screen shows: 


Re-enter new password: 


Type your password again and press | ENTER |. The screen shows your user 
prompt. The new password is substituted for the old one. 
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installing and using 
applications programs 


As the System Administrator, you are responsible for installing applications 
programs and for instructing users in how to access them, use them, and back up 
the data they enter. To install an applications program, you must be logged in as 


root. 


installing an applications program 


1. 


At the root prompt, type: 
instali | ENTER 


The screen shows the following Installation Menu: 
Installation Menu 


l. to install 
q. to quit 


Please select 


Type 1 | ENTER | to select the Install option. The screen shows: 
Insert diskette in Drive ð and press <ENTER> 


Insert the first installation diskette in Drive @, close the drive door, and press 
ENTER |. If the application is complete on 1 diskette, the screen shows: 


Installation complete--Remove the diskette, then 
press <ENTER>. 


If the application is contained on more than 1 diskette, XENIX tells you when 
to insert the remaining diskettes and then displays the above message when 
the installation is complete. 


After you press | ENTER |, your screen shows the Installation Menu again. If you 
wish to install another application, type 1 | ENTER | and follow the above 
instructions. Otherwise, type q | ENTER| and you return to the root prompt. 


accessing applications programs 


Both the System Administrator, logged in as root, and the user can access 
applications programs. You, as System Administrator, can, however, restrict a user’s 
access. Instructions for how to do this are in Chapter 6. 
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To access an applications program for which you have permission as a user, at the 
user prompt type: l 


program name | ENTER 


Although the System Administrator, logged in as root, can access all application 
programs on the system, we recommend that you always do so as a user. 


using Multiplan ™, Unify®, and Scripsit® 16 


If you are using the DT-100 and the following versions of these applications, you 
must install a special DT-100 file after you install the application. The versions are: 


Multiplan ™ Version 01.06.00 (Cat. No. 26-6480) 
Unify® Version 01.00.00 (Cat. No. 26-6415) 
Scripsit® 16 Version 01.00.00 and @1.00.01 (Cat. No. 26-6431) 


After you install the application, at the root prompt, type: 


dt1@@-install | ENTER 


The screen shows: 


DT16@ Terminal 
Installation Menu 


1. to install 
q. to quit 
Please Select: 


Now, type 1 (ENTER |. When prompted, insert the DT-100 Installation diskette (Cat. 
No. 700-2020 or 26-6052) into Drive @. 


All later versions of these applications do not require any modification. 


using Profile® 16 


You must use Version 01.01.00 (or later) of Profile® 16 (Cat. No. 26-6412). 


using accounting applications 


A new version of runcobol lets you use the and keys on the DT-100 for 
accounting applications. 


backing up applications files 


Backing up is a very important procedure in all data processing environments. It is 
analogous to making a carbon copy or a photocopy of a document you typed on a 
typewriter. 

Backing up in a Computerized system, however, is even more important. You need 
not only to make a copy of your documents but also to make a copy of the system 
on which you created the documents. This is your responsibility as System 
Administrator, and the next chapter tells you how. 


235 


4/installing and using applications programs 


The manual that comes with an applications program may contain instructions for 
making a copy on floppy diskette of the data you created on your hard disk. If so, 
follow those instructions exactly to back up your applications files. If the manual 
does not contain backup instructions, you can use the procedure that follows. 


Before you can make backups, however, you must format the diskettes or cartridges 
onto which you will copy data. Both the System Administrator and the User can 
format diskettes and cartridges using the diskutil program, which you access from 
the XENIX Boot prompt. These may also be formatted while XENIX is running by 
using the format utility. 


You can format as many diskettes/cartridges as you wish at any one sitting. We 
recommend that you keep an ample supply of formatted disks on hand. This can 
save time when you wish to back up files at the end of a working period. 


Diskettes and disk cartridges can be formatted in one of two ways; either by using 
diskutil or by using the format(C) command. Diskutil is a stand-alone utility for 
formatting and copying disks. Diskutil is generally faster than the format command, 
but XENIX must be shutdown for diskutil to be used. format allows floppy disks 
and disk cartridges to be formatted while XENIX is running. ` 


Format should not be used on floppy disks when the system has several users 
logged-on as it may take several minutes to format a single disk, and there is the 
potential of incoming characters being lost on some TTY lines. 


Note: If a disk is formatted using format and it is bad, a message indicating this is 
displayed, but the disk may still be readable enough to be accepted by XENIX. You 
should not attempt to use a disk that has failed formatting. 


For information on using the format command, see format(C). 


formatting diskettes using Diskutil 


1. Because you are currently logged in to the system, shut down the system and 
then press the reset switch. The following boot prompt appears on your 
screen: 


Xenix Boot?» 


2. Beside the prompt, type: 
diskutil | ENTER 


3. Your screen displays the following message: 


Diskutil: format or copy floppy diskettes 
format hard disks 
format or copy disk cartridges 


At any time you may type <break> or press RESET 
to abort the procedure. The backspace key may be 
used to correct single characters of your input. 
End each line you type by typing <enter>», 


Diskutil: Hard, floppy, or cartridge (h, f, or c)? 


4. Type f| ENTER |. The screen shows: 
Copy or format Cec or f)? 


5. Type f | ENTER |. The screen shows: 
Format floppy disk in drive number (6@..3)? 


Respond by typing the number of the floppy drive into which you plan to 
place the floppy diskette to be formatted. Then press [ENTER |. 
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Now the screen shows: 
Select the format to be used: 

x or ENTER for Tandy 16/6000 XENIX format. 

i for SD 128x26 (3740/4960) format. Cx, ENTER or i)? 
Respond by pressing | ENTER |. The other format is used to produce disks that 
can be read by other computer systems that only support single-density 
diskettes. 

Now the screen shows: 
About to format Tandy XENIX floppy disk in drive @. 
Type <enter> to proceed or <break> to abort: 
Insert the diskette and press | ENTER |. Be sure the diskette has a write-enable 
tab. When the diskette is formatted, the screen shows: 


Disk format and verification complete. 
About to format Tandy XENIX floppy disk in drive @. 
Type “enter? to proceed or <break> to abort: 


lf you will need more than 1 diskette to back up your files, remove the 
formatted diskette, insert a new diskette, and press | ENTER |. When you have 
formatted all the diskettes you will need, press the reset switch, and the 
XENIX boot prompt reappears on your screen. 


formatting disk cartridges 


Q 


1. 


If you are currently logged in to the system, shut down the system and then | 
press the reset switch. The following boot prompt appears on your screen: 


Xenix Hoot> 
Beside the prompt, type: 
diskutil | ENTER 


Your screen displays the following message: 


Diskutil: format or copy floppy diskettes 
format hard disks 
format or copy disk cartridges 


At any time you may type <break> or press RESET 
to abort the procedure. The backspace key may be 
used to correct single characters of your input. 
End each line you type by typing <enter>. 


Diskutil: Hard, floppy, or cartridge (h, f, or c)? 


Type c | ENTER |. The screen shows: 


Copy or format Cc or f)? 
Type f | ENTER |. The screen shows: 
Drive number C@ or 1)? 


Respond by typing the number of the drive into which you plan to place the 
cartridge to be formatted. Then press [ ENTER |. 


Now the screen shows: 


‘Desired interleave factor C<enter> for default)? 
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You should press { ENTER | for the default value. The screen now shows: 


About to format 18 megabyte cartridge in drive @. 
Type <enter> to proceed or <break> to abort. 


Insert the cartridge into the drive you selected and press | ENTER |. Be sure that 
the cartridge is not write protected. When the cartridge is formatted, the 
screen shows: 


Cartridge successfully formatted 


The screen now shows: 


Format another CY or N)? 


lf you will need more than 1 cartridge to back up your files, type Y [ENTER |. 
You will then be prompted to insert another cartridge. 


When you have formatted all the cartridges you will need, type N | ENTER). 
Then if you are ready to run XENIX, press the reset switch, and the XENIX 
boot prompt reappears on your screen. 


Notes About Disk Cartridges: XENIX locks disk cartridges while they are in 
use. This is to prevent anyone from removing a disk while it is in motion. 
During this time, the cartridge release button is ignored. 


When the drive is no longer in use, XENIX unlocks the drive so you can 
remove the disk cartridge. 


if you are using the disk cartridge as a mountable filesystem, XENIX keeps the 
drive locked until you unmount the filesystem. Note that if you improperly 
shutdown your XENIX system or if it crashes with the cartridge mounted or in 
use, XENIX does not unlock the drive. To unlock it, press the reset switch. 
XENIX unlocks the drives at the Xenix Boot> prompt so you can remove the 
cartridge disk. 


backing up your files 


You are now ready to back up your applications files. 


ie 


Place your formatted disks within easy reach and log in to XENIX as a user. 
Now type: 


tsh | ENTER 


Insert a formatted diskette or cartridge in Drive 0, and at the tsh prompt 
(tsh>), type: | 


save @ -ss /usr/name/ filename | ENTER 


save is the command that tells XENIX to copy information from the hard disk. 
@ indicates that the information is to be copied onto the diskette in floppy 
Drive @. -ss indicates that the diskette is single-sided. If you are using double- 
sided diskettes, you type -ds. If you are using a cartridge, you type -c10, if 
you have a 10 meg disk cartridge system. If you have the 20 meg system, use 
-c20. name is your login name, and filename is the name you gave the file 
when you created it. 


You can back up more than 1 file on a disk. To do so, simply specify each 
filename on the command line; separate filenames with spaces. For example: 


save @ -s5 /usr/name/filename /usr/name/filename 
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Be sure to type the command exactly as shown, including the spaces and 
slashes. Substitute your name and the filename appropriately for the words in 
italics. 


When the screen indicates that the file or files have been found, your backup 
is complete. To leave tsh, type: 


exit | ENTER 


Your user prompt now appears on the screen. 


restoring applications files to your hard disk 


If you wish, you can later restore to your hard disk the information you copied to 
floppy diskette or cartridge. 


1. 


Log in to XENIX as a user. Place the disk you wish to restore in Drive @. At 
your prompt, type: , 


tsh 

To restore from floppy diskette, type at the tsh prompt: 
restore 0 ; 

To restore from a 10 megabyte cartridge, type at the tsh prompt: 
restore @ -c10 

To restore from a 2@ megabyte cartridge, type: 


restore @ -c2@ | ENTER 


When the screen indicates that the file or files have been restored, you can 
then restore more files or exit tsh. 


You can also use tar to back up and restore. For instructions, see Chapter 9. 
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directories and files 


XENIX is organized in a system of directories and files. Directories can themselves 
contain other directories, or subdirectories, which in turn contain files. XENIX 
stores information in directories and files in much the same way that a filing 
cabinet does. A directory is similar to the file cabinet itself, and a subdirectory is 
like a drawer in a file cabinet. Within the drawer are folders, some of which 
contain other folders that contain memos, letters, reports, charts—all kinds of 
information. 


XENIX directories and files are organized “hierarchically”; that is, all directories 
and files branch from a single root. A chart of these directories and files looks like 
an inverted tree. The trunk is at the top, representing the “root” directory, and the 
main branches, smaller branches, and twigs are other directories and 
subdirectories. The leaves are the files. 


Below is an example of a typical XENIX organizational structure. 


/ n 
(root) 


donna] [bob] [bin] [amp 


When you log in to XENIX as root, you are in the root directory. XENIX uses the 
slash (/) to symbolize the root directory. When you create a user, XENIX 
automatically assigns that user a workspace called /usr/name. /usr is a major 
XENIX directory that contains the workspaces of all users on the system. The user's 
login name ts a subdirectory of /usr; it is also called the user's “home directory.” 


The user may create further subdirectories in his or her home directory and may 
create files within those subdirectories. To access a file you have already created, 
you need to know its ‘’pathname.’” A pathname is exactly what the word implies— 
the path XENIX takes to find the file. It consists of the directories and 
subdirectories within which the file exists and the name of the file. 


For purposes of the examples that follow, now log in as user. You are automatically 
in your home directory. 
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creating directories and files 


Although you can use XENIX to perform many complicated tasks, you can also use 
it to perform some simple tasks that will streamline your office routine. These 
examples show you how. 


1. 


To use XENIX as a reminder service, first create a subdirectory within which 
you can create a “To Do” file. At the prompt, type: 


mkdir schedule | ENTER | 


Now your home directory contains a subdirectory called “schedule.” You are 
still in your home directory, however. To create a file in the schedule 
directory, you must be in that directory. To get to the schedule directory, you 
must change directories. Type: 


cd schedule 
Within the schedule directory, you can now create a “To Do” file. At the 
prompt, type: 

cat >todo | ENTER 


The file is created, and you can now place information in it. Notice that we 
typed the filename tn all lowercase letters and omitted the space between the 
2 words. You can use any characters in a filename except the slash. You can 
also use spaces. However if you use spaces or some special characters when 
you access the file, you must enclose it in single quotes. 


Note: You can use the same filename for different files, but the files must be 
in different directories. The same file can exist several times in the same 
directory, but each time it must have a different name. 


You are now ready to make notes in your todo file. Type whatever you wish. 
To end a line, press [ ENTER |. When you finish, type d, and the system 
prompt appears on your screen. 


Now create another directory and another file. This time create a file of 
frequently used names, addresses, and phone numbers. First, determine your 
current directory, that is, the directory you are in at present. To do so, type: 


pwd | ENTER 
The screen shows: 


/usr/name/schedule 


To create another directory in your home directory, you must again change 
directories; that is, you must leave the schedule directory and go to the 
/usr/name directory. To do so, type: 


cd /usr/name 
Now you are ready to create another directory called phonebook. To do so, 
type: 
mkdir phonebook 
To move to the phonebook directory, type: 
cd phonebook 
Verify that you are now in the phonebook directory by typing: 


pwd | ENTER 
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9. To create a file, type: 


cat >namelist f ENTER 


As in Step 4, make entries in your file and then type | CTRL] d. The user 
prompt appears on your screen. To return to your home directory, type: 


cd /usr/name | ENTER 


You can also type cd | ENTER | (without the filename) to get to your home 
directory. 


displaying the contents of directories and files 


1. You can verify that the directory and files you created now exist. To list (or 
display) on the screen the contents of your home directory, type: 


Ic 
The screen shows: 

phonebook schedule. 
Note: The list is in alphabetic order. 


2. — To display the contents of the todo file on the screen, first move to the 
schedule directory. Type: 


cd schedule 
3. Now type: 


cat todo | ENTER a 


Your screen shows the list of things you have to do that you entered earlier. 
Now display the contents of namelist. First, move to the phonebook directory. 
To do so, type cd /usr/name/phonebook [ENTER |. Now type: 


cat namelist | ENTER 


Note: For an explanation of some new words you've been using in these 
examples (cat, cd, Ic, mkdir), see the “Quick Reference Guide to 
Commands” section in this manual. 


moving files 


32 


You now have 2 directories in your home 
directory, and you have a file in each of 
these directories. In the XENIX hierarchical 
system, a diagram that shows these files and 
directories looks like this: 


namelist 
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You may occasionally want to move a file from one directory to another. For 

purposes of example, let's move the todo file out of the schedule directory and into 

the phonebook directory. 

1. After you displayed the namelist file above, you were in the phonebook 
directory. To move the file, first position yourself in the directory in which 
that file exists. To do so, type: 


cd /usr/name/schedule 
2. Verify that you are in the schedule directory by typing pwd [ENTER |]. Now, at 
the prompt type: 
mv todo /usr/name/phonebook 
3. Now move to the phonebook directory. Type: 
cd /usr/name/phonebook 
4, List the contents of the phonebook directory. Type: 


Ic [ENTER | 


Your screen shows that the phonebook directory now contains 2 files— 
namelist and todo. 


Note: To keep the todo file in the schedule directory and also place a copy 
of it in the phonebook directory, follow Steps 1-4 above and change Step 2 
slightly. Instead of typing mv (move), type cp (copy). 


removing a file 


To remove, or delete, a file you must position yourself in the directory that contains 

the file. For purposes of this example, delete the todo file from the phonebook 

directory, where you last placed it. 

1. First, verify that you are in the phonebook directory by typing pwd [ENTER ]. 
Now, type: 


rm todo | ENTER 


2. . Now list the directory contents to verify that todo has indeed been removed. 
Type: 
Ic | ENTER 
Your screen shows that the directory now contains only 1 file—namelist. 


Note: If you want to remove all the files in a directory, you can do so by 


typing rm * | ENTER |. The asterisk (*) is the wild card character and in this 
case tells XENIX to remove all files. Use rm * with extreme caution. You can 


inadvertently lose all your files. 


removing a directory 


Before you can remove a directory, you must first remove all the files in that 
directory. Since you have already removed the file from the schedule directory, it is 
empty and you can delete it. 
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` You cannot be positioned in a directory you are removing. You were in the 


phonebook directory when you deleted the todo file. Type pwd to 
verify that you are still there. 


To return to your home directory, type: 
cd /usr/name | ENTER 
Now to remove the schedule directory, type: 


rmdir schedule | ENTER 


To verify that the schedule directory no longer exists, list the contents of your 
home directory. Type: 


Ic /usr/name | ENTER 


Your screen shows that your home directory contains the phonebook 
directory but not the schedule directory. 
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permissions 


As System Administrator logged in as root, you have access to every directory, file, 
and program in your XENIX system. This means that you have total read, write, 
and execute permission. in other words, you can ask XENIX to display any file on 
the screen and you can read its contents. You can also use ed to change its 
contents (write to the file). In addition, you can execute, or run, any program in the 
system. 


These 3 kinds of permissions—read, write, and execute—can be given or denied to 
anyone logged in to the system. One of your responsibilities as System 
Administrator is to set permissions. Before doing so, however, you need to knaw 
how permissions affect a user’s ability to access the system. 


if you have read permission for a file, you can display it on the screen and read the 
information in it. lf you have read permission for à directory, you can display its 
“table of contents” an the screen. That is, you can see a list of all the 
subdirectories and files in that directory. 


If you have write permission for a file or a directory, you can move it, add to it, 
defete information from it, remove it, rename it, or change it in any way. lf you 
have write permission for a directory, you can create subdirectories and files 
within it. $ 5 

If you have execute permission for a program, you can run it. lf you have execute 
permission for a directory, you can move into it and search it for files, such as 
programs to run. 


The 3 kinds of permission are available to 3 categories of users: individual users 
(u), groups (g), and others (0). An individual user is the owner of a particular file or 
directory. He or she usually has read, write, and execute permission for all files 

and directories in his or her home directory. 


A group of users may have collective permissions for a particular file or directory- 
For example, if several users are working on a single project, you, as System 
Administrator, can give them group permissions rather than individual user 
permissions. 


Others are anybody and everybody who neither own a file or directory nor are 
members of an owner’s group. 


reading permission settings 


Whenever a user creates a file or directory, XENIX automatically assigns these 
permissions: read and write for the user, read for the user's group, and read for 
others on the system. . 
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You can look at the permission settings on a particular file or directory. For 
purposes of example, let’s look at the phonebook directory you created earlier. To 
do sa, log in as root, and at the root prompt, type: 


lc -| /usr/name { ENTER 


Of course, use the user name under which you created the directory. Your screen 
shows: 


Jo a press = 1 name group 344 Aug 16 15:00 .profile 
drwxr-xr-x 2 name group 32 Aug 16 17:15 phonebook 


Note: Your screen shows 2 entries in this directory—.profile and phonebook. The 
date for .profile is the date you created this user. The date for phonebook is the 
date you created your phonebook directory. 


For purposes of example, lets look in detail at the entry for your phonebook 
directory. The 1@-character letter-and-dash grouping that begins with d describes 
the permissions. l i 


d Indicates that this is a directory, not a file. A file is indicated by 
a dash (-) in this place. 

rwx The characters in these next 3 positions indicate the individual 
user’s permissions. In this case, they are read, write, and 
execute. 

r-X These 3 characters indicate the permissions of the members of 


the individual user’s group. In this case, they are read and 
execute, not write, since a dash is in the write position. 


r-X These 3 characters indicate the permissions of others. In this 
case, they are read and execute. 


The number 2 following the permission settings is the number of links for this 
directory. (A link is a connection between blocks.) XENIX uses this information 
internally. 


The next numbers show the size of the directory in bytes. 


The date and time indicate when the directory was created or last changed. The 
last item on the line is the name of the directory. 


setting and changing permissions 
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To set or change permissions, you must be in the directory in which you want to 
make changes. You use the following characters when changing permissions: 


u user + add 

g group ~ remove 
O other = set 

a all 


You also use r, w, and x to indicate read, write, or execute permission. 


For purposes of example, let's change the permissions for the phonebook directory. 


r Fay ee es eee i er ee eee ee 
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Position yourself in the /usr/name/phonebook directory. 
To give the individual user, the group, and others read, write, and execute 
permission, type: 
chmod a = rwx /usr/name/phonebook 
chmod tells XENIX to change mode. 


To verify that the settings have been changed, type: 


Ic -l /usr/name | ENTER 


Your screen shows that everyone now has read, write, and execute 
permission. The settings are: 


drwxrwxrwx 


To remove permissions, you use the minus sign. Let's remove write 
permission for others. At the prompt, type: 


chmod o-w /usr/name/phonebook 


You can verify that the changes were made. To add permission, you use the 
same format, or syntax as above, substituting the appropriate user character 
and the plus sign. 
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backing up 


Backing up is a standard operating procedure that ensures the safekeeping of the 
information you store on your hard disk and on floppy diskettes. Data can be lost 
under various circumstances—a power failure, inadvertent removal of files, a 
hardware malfunction, and so on. 


As the System Administrator, one of your primary responsibilities is making system 
backups. Only you, logged in as root, may do this. 


We recommend that you schedule regular backups; daily is probably best. Label 
your floppy diskettes so that you can easily retrieve the appropriate ones when 
necessary, and keep them in a place where they cannot be damaged by excessive 
heat or dust or by a magnetic field. 


With XENIX you can back up your hard disk to floppy diskette, and you can back 
up one floppy diskette to another. Since your XENIX is new and this is the first 
time you have backed it up, XENIX requires that you do a full system backup. After 
this, you can do a periodic backup, or a backup that copies only those files you 
created since the last full system backup. 


backing up your hard disk to floppy diskettes 
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First, using format or diskutil, format all the floppy diskettes you will need. If you 
are ever unsure about the number, format more diskettes rather than fewer. For this 
example, format 5 diskettes. (See Chapter 4 for instructions.) After doing so, press 
the reset switch and reboot XENIX. 


1. Log tn as root. 


2. Now to begin backing up your hard disk, at the root prompt type: 
sysadmin 


3. The following menu appears on your screen: 


File system Maintenance 


Type 1 to do daily backup, 

to backup all files, 

to get a backup listing, 
to restore a file, 

to restore a backup, 

to check a file system, 
q to quit 


Out WM 


>» Enter Number: 


4. Type 2 to back up ail files. The screen shows: 


FULL SYSTEM DUMP 
Backup which hard drive (8-3)? 


aX 


—— a en mamae 
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5. Type the number of the hard drive you want to back up (in this case Drive @, 
or the primary hard disk) and [ENTER }. The screen shows: 


Backup to Cartridge or Floppy drive? 


6. Type f [ENTER |. The screen shows: 
Backup to which floppy drive (8-3)? 


7. Type @ | ENTER |. Now the screen shows: 
Are your floppy diskettes Single or Double sided? 


8. If you are using single-sided floppy diskettes, type S | ENTER }. If you are using 
double-sided diskettes, type D [ENTER }. After you enter either S or D, the 
screen shows: 

Insert volume in Floppy drive @, then press <ENTER> 

9. When the diskette is full, the screen shows: 


Change volumes and press <ENTER> fo continue. 


10. Insert a new formatted diskette. The cursor stays at the end of the prompt 


until you press | ENTER }. 
Note: Be sure to label each diskette with the date, and number the diskettes 
in the order in which the backup was done. 
When the entire file system is backed up, the screen shows: 
DONE 
11. XENIX returns to the File System Maintenance menu. Type q (ENTER | to quit, 
and the root prompt appears on your screen. 


Note: To do a daily backup, or a backup of all files since the previous 
complete backup, select 1 at the File System Maintenance menu and respond 
to the prompts in a manner similar to the above instructions. 


backing up your hard disk to cartridge 


1. Log in as root. 
2. Now to begin backing up your hard disk, at the root prompt type: 


sysadmin 


3. The following menu appears on your screen: 


File System Maintenance 


Type 1 to do daily backup, 

fo backup all files, 

to get a backup listing, 
to restore a file, 

to restore a backup, 

to check a file system, 
q to quit 


QUN RPUDN 


> Enter Number: 


4. Type 2 to back up all files. The screen shows: 


FULL SYSTEM DUMP 
Backup which hard drive (8-3)? 


5. Type the number of the hard drive you want to back up (in this case Drive @, 
or the primary hard disk) and [ENTER }. The screen shows: 


Backup to Cartridge or Floppy drive? 
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6. Type c{ ENTER |. The screen shows: 
Backup to which cartridge (8-1)? 


7. Type Ø (ENTER). Now the screen shows: 


Insert volume in Cartridge drive Ø, then press <ENTER> 
8. When the cartridge is full, the screen shows: 


Change volumes and press <ENTER> to continue. 


9. Insert a new formatted cartridge. The cursor stays at the end of the prompt 
until you press | ENTER }. 


Note: Be sure to label each cartridge with the date, and number the 
cartridges in the order tn which the backup was done. 


When the entire file system is backed up, the screen shows: 
DONE 


10. XENIX returns to the File System Maintenance menu. Type q to quit, 
and the root prompt appears on your screen, 


Note: To do a daily backup, or a backup of all files since the previous 
complete backup, select 1 at the File System Maintenance menu and respond 
to the prompts in a manner similar to the above instructions. 


Notes About Disk Cartridges: XENIX locks disk cartridges while they are in 
use. This is to prevent anyone from removing a disk while it is in motion. 
During this time, the cartridge release button is ignored. 


When the drive is no longer in use, XENIX unlocks the drive so you can 
remove the disk cartridge. 


lf you are using the disk cartridge as a mountable filesystem, XENIX keeps the 
drive locked until! you unmount the filesystem. Note that if you improperly 
shutdown your XENIX system or if it crashes with the cartridge mounted or in 
use, XENIX does not unlock the drive. To unlock it, press the reset switch. 
XENIX unlocks the drives at the Xenix Boot> prompt so you can remove the 
cartridge disk. 


backing up floppy diskettes 


40 


In a multiuser environment, you may on occasion need duplicates of files that have 
been backed up on floppy diskette. You back up floppy diskettes with diskutil. 


1. If you are at the root prompt, shut down the system and press the reset 
switch. At the XENIX Boot prompt, type: 


diskutil 
2. The screen displays the following message: 


Diskutil: format or copy floppy diskettes 
format hard disks 
format or copy disk cartridges 


At any time you may type <break> or press RESET to 
abort the procedure. The backspace key may be used 
to correct single characters of your input. End each 
line you type by typing ¢enter>. 


Diskutil: Hard, floppy, or cartridge Ch, f, or c)? 


Ce m m Ml 
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3. Type f | ENTER], and the screen shows: 
Copy or format Cc or f)? 


4. Type c [ENTER |, and the screen shows: 


Source drive number C0,.3)? 
5. For purposes of this example, you must have at least 2 floppy drives. You will 
place your source diskette in Drive ® and your destination diskette in Drive 1. 
To answer the prompt in Step 4, type @ | ENTER |. The screen shows: 


Destination drive number (€§@..3)? 


6. Type and the screen displays the following instructions: 


Insert source disk in drive 9 
Insert destination disk in drive 1 


Type <enter> to proceed or <break> to abort: 
7. Place the diskettes in the appropriate drives and press | ENTER |. The screen 
shows the following message while the backup is in progress. 


This will take about 77 seconds. 
Copying cylinder __, side __ 


As diskuti! copies each cylinder, the number of that cylinder scrolls past. If 
you are using single-sided diskettes, the side number remains @. If you are 
using double-sided diskettes, the side number changes from @ to 1 after Side 
1 is copied. When the copy is complete, the screen shows: 

Disk copy and verify complete. 


| 

l -—- 

a Insert source disk in drive B 

Ps hes Insert destination disk in drive 1 


Type <enter> to proceed or <break> to abort: 
8. If you wish to copy more diskettes, remove the diskettes just copied, insert 
others, and follow the instructions above. 


9. Ifyou do not wish to copy more diskettes, press the reset switch, reboot 
XENIX, and log in as root. 


backing up disk cartridges 


in a multiuser environment, you may on occasion need duplicates of files that have 

been backed up on cartridges. One way to back up cartridges is using diskutil. 

Note: You must format the destination cartridge with diskuti! before making 

backups. 

1. If you are at the root prompt, shut down the system and press the reset 
switch. At the XENIX boot prompt, type: 


diskutil | ENTER 


2. The screen displays the following message: 


Diskutil: format or copy floppy diskettes 
format hard disks 
format or copy disk cartridges 


At any time you may type “break> or press RESET to 
; abort the procedure. The backspace key may be used 
i to correct single characters of your input. End each 


Sar line you type by typing <enter>. 
Diskutil: Hard, floppy, or cartridge Ch, f, or c)? 
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Type c | ENTER |. The screen shows: 
Copy or format Cc or f)? 


Type c | ENTER]. The screen shows: 


Source drive number (0 or 1)? 


For purposes of this example, you must have two of the disk cartridge drives. 
Place your source cartridge tn Drive @ and your destination cartridge in Drive 
1. To answer the prompt in Step 4, type @ | ENTER |. The screen shows: 


Destination drive number (C8 or 1)? 


Type 1 | ENTER | and the screen displays the following instructions: 


Insert source cartridge in drive § 
Insert destination cartridge in drive 1 


Type ¢enter> to proceed or <break> to abort. 


Place the cartridges in the appropriate drives and press [ENTER }. The screen 
shows the following message while the backup is in progress: 


Reading @00000060 Writing aao00s008 


Diskutil copies the cartridges by reading in several blocks at one time, then 
writing them out to the destination cartridge. As diskutil copies each set of 
blocks, the number of the starting block is displayed. The numbers displayed 
are hexadecimal values. When the copy is complete, the screen shows: 


Copy complete 
Unlocking @ Unlocking 1 


Diskutil: Hard, floppy, or cartridge (h, f, or c)? 


If you wish to copy more cartridges, remove the cartridges just copied, insert 
others, and follow the instructions above. 


If you do not wish to copy more cartridges, press the reset switch, reboot 
XENIX, and log tn as root. 


Notes About Disk Cartridges: XENIX locks disk cartridges while they are in 
use. This is to prevent anyone from removing a disk while it is in motion. 
During this time, the cartridge release button is ignored. 


When the drive is no longer in use, XENIX unlocks the drive so you can 
remove the disk cartridge. 


If you are using the disk cartridge as a mountable filesystem, XENIX keeps the 
drive locked until you unmount the filesystem. Note that if you improperly 
shutdown your XENIX system or if it crashes with the cartridge mounted or in 
use, XENIX does not unlock the drive. To unlock it, press the reset switch. 
XENIX unlocks the drives at the Xenix Boot> prompt so you can remove the 
cartridge disk. 
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restoring information to your 


hard disk 


Maintaining an up-to-date library of backup diskettes or cartridges lets you easily 

- and accurately restore the information to your hard disk if for any reason it ceases 
to function properly and your data is destroyed. You can also use your backup 
diskettes or cartridges to transfer the information on one hard disk to another hard 
disk. 


As System Administrator, you are responsible for maintaining a complete and 
accurate backup library and for restoring information to hard disk when necessary. 
To do so, you must be logged in as root. 


If you have been working through this manual in a tutorial fashion, and we assume 
that you have, the following instructions are for information only. Do not use them - 
now. Use them only when your hard disk fails and you need to restore data. At 

present, your hard disk is up and running, and the information on tt is intact. If you 
attempt to restore over a properly functioning hard disk, you can damage your files. 


These instructions for restoring information to hard disk are organized according to 
system design—Restoring a Primary Hard Disk with 2 or More Floppy Drives or a 
Cartridge, Restoring a Secondary Hard Disk, and Restoring a Primary Hard Disk 
with 1 Floppy Drive. When you need to restore a hard disk, follow the instructions 
that correspond with the design of your system. 


restoring a primary hard disk with 2 or more 
floppy drives or a cartridge 


Warning: Use these procedures only when you encounter serious difficulties with 
your hard disk that can be remedied in no other way. 


Your XENIX package contains a diskette labeled File Maintenance Diskette. You use 
it to quickly and efficiently restore files or an entire system to your primary hard 
disk. Before you begin, be sure that all your backup diskettes/cartridges are at 
hand. Turn on your hard disk, turn on your computer, and format your hard disk if 
necessary. (See Chapter 1 if you need format instructions.) 


1. Insert the File Maintenance Diskette in Drive @. Press the reset switch, and 


then press | BREAK | and | REPEAT | simultaneously until the following appears on 


your screen: 


Xenix Boot? 
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2; 


Press | ENTER | and your screen shows: 


System loaded... 
Change root if desired, 
type <enter> to proceed or <break> to abort 


Press | ENTER | and the following menu appears: 


File System Maintenance 
Type 1 to get a backup listing, 

2 to restore an entire dump, 

3 to restore a daily dump, 

4 to check a file system, 

q to quit 
Note: Restoring an entire backup is restoring everything that was backed up 
from your hard disk to floppy diskette or cartridge, including your XENIX 
system. Restoring a daily backup is restoring the information on diskettes/ 
cartridges that was obtained during a periodic backup. 


When you have both an entire backup and a daily backup to restore, first 
restore the entire backup. In other words, at the File System Maintenance 
Menu, first select 2. When the entire backup is fully restored, then restore the 
daily backup by choosing 3 from the File System Maintenance Menu. 


Type 1 | ENTER | to verify that you are restoring the latest backup. Answer the 
prompts, and insert your first backup diskette/cartridge into the appropriate 
drive when asked to do so. 


When the backup listing is complete, press to return to the File 

System Maintenance menu. Now type 2 [ENTER |, and the screen shows: 
RESTORE AN ENTIRE BACKUP SET TO A HARD DISK 
Restore to which hard drive (9-3)? 


Note: Although XENIX gives you the option of entering the number of a 
secondary hard drive, enter only @ in response to this prompt. 


Type @ [ENTER |. The screen shows: 
Restore from C)artridge or F)loppy drive? 


Type F [ENTER| or C as appropriate. Answer the following 


question about the drive that is to be backed up. The screen will 
show: 


Do you want the standard size swap area [y or nl? 


Normally, you will give the same answer as you did when you installed the 
system. After you enter the information, your screen shows: 


About to erase any data on drive § 
Press ENTER to continue or BREAK to abort: 


Note: Any existing information on your hard disk will be overwritten when 
the full system backup is restored. Your backup diskettes/cartridge contain 
everything that was on the hard disk; so you need not be concerned about 
this warning. It is simply a reminder. 


Press | ENTER |, and then answer the prompts as they appear on the screen. 
During the process of restoring, you may see the following message on your 
screen: 


"/dev/rhd@" contains data; press <ENTER> to continue 
or <BREAK> to abort: 


1@. 
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Press | ENTER | and continue restoring. When all the information on your 
backup diskettes/cartridges has been restored to your hard disk, your screen 
shows: 


End of Dump 


The File System Maintenance menu reappears on your screen. Type 4 [ENTER 
to select check a file system. Answer the prompts as they appear. 


When the verification of the file system on your hard disk is complete, the 
File System Maintenance menu appears on your screen. Press q | ENTER | to 
quit, and wait until your screen shows: 


[Z88 Control System Halted] 


You can now press the reset switch and boot XENIX. 


restoring a secondary drive 


Your XENIX Core contains a special program called /etc/sysadmin. You can use it 
to restore files or an entire system to a secondary hard disk. 


restoring files 


ie 


Log in to XENIX as root, and at the root prompt type /etc/sysadmin | ENTER |. 
The following menu appears: 


File System Maintenance 


to do daily backup, 
to backup all files, 
to get a backup onan 


Type 1 
2 
3 
4 to restore a file, 
5 
6 


to restore a backup, 
to check a file system, 
q to quit 


> Enter Number: 


Type 3 | ENTER | to verify that the diskettes/cartridges you are about to restore 
to hard disk are the latest backup. 


Note: If you have made a daily backup since the last periodic backup, first 
restore the periodic backup and then restore the daily backup. 
The screen shows: 


PRODUCE BACKUP LISTING 
Read from Cartridge or Floppy drive? 


Type c if you are restoring from cartridge or f if you are restoring from floppy 
diskette. Press and the screen shows: 


_ Insert first volume in drive zero, then press <ENTER> 


After you press | ENTER ], the screen briefly displays the following: 


LIST IS IN /tmp/backup.list 
Enter ’Y’% to see the list on your screen now. 


Type Y [ENTER J. 


The menu appears again. To restore a file, type 
4 | ENTER |. The screen shows a list of a file systems, then: 


Enter directory name from above list Cor /) 
(Directory name must begin with "/") 
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7. Enter the name of the file system to which you want to restore. The screen 
shows: 


Enter Pathname of Files to Restore, 

If a directory is specified, all files in it will 
be restored. 

Type one name per line, blank line to terminate 


Enter Pathname: 
8. When you have entered all pathnames, press | ENTER | at the prompt. The 
screen shows: 


These files will NOT be restored with numbers as 
names, that is, they will be restored to their 
correct places. 


Restore from CJartridge or FJloppy drive? 


9. After you have answered this prompt, you are asked from which drive you 
want to restore. 


10. Type the number of the drive from which you want to restore. Press | ENTER J. 


11. Answer the succeeding prompts and follow the instructions exactly as they 
appear on your screen by inserting your first backup diskette/cartridge and 
specifying the volume number. When all files have been restored to the hard 
disk, XENIX returns to the File System Maintenance menu. 


12. Type q to quit. 


restoring an entire system 


To restore an entire system of files to hard disk, follow the above procedures, but at 
Step 1, select 5. 


1. The screen shows: 
RESTORE A HARD DISK 
Restore which hard disk (8-3)? j 

2. Type the number of the hard disk you wish to restore. The screen shows: 
Restore Full or Daily backup 


Type F for a full backup or D for a daily backup. The screen 


now shows: 
Restore from Cartridge or F)loppy drive? 


3. Type c if you are restoring from cartridge or f if you are restoring from floppy 


diskette. Press | ENTER |. 


4. You are now asked from which drive you want to restore. If you are restoring 
from floppy, the screen shows: 


Are your floppy diskettes Single or D)ouble sided: 


Type the letter corresponding to the type of diskettes you are using and 


[ENTER]. 


5. The screen shows: 
Insert volume in Floppy drive n, then press ENTER: 
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Insert your first backup diskette/cartridge and press | ENTER |. After a brief time, 
the screen shows: 


Mount desired backup volume: Specify volume: 


Type 1 | ENTER |. When the restoration is complete, the File System 
Maintenance menu reappears. 


Type 6 | ENTER | to check a file system. If problems are encountered during the 
check, the system tells you and awaits your input. If the check is satisfactory, 
you are returned to the menu. 


Type q to quit. 


restoring a primary hard drive with 1 floppy drive 


To restore an entire system to a primary hard disk when you have only 1 floppy 
disk drive and your backups are on floppy diskette, first install the Core. (26e 
Chapter 1 for instructions.) Now log in to XENIX as root. 


1. 


At the root prompt, type: 
/etc/sysadmin 


The File System Maintenance menu appears on your screen. From this point 
on, follow the instructions given above in “Restoring a Secondary Hard 
Disk.” 


Note: You cannot use option 5, RESTORE A HARD DISK, in this case. You 
must use option 4 and type / | ENTER | at the Enter Pathname: prompt. 
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another way to back up 
and restore 


Sometimes you want to back up only a single file or a few files and directories. 
XENIX lets you do this quickly with a program called tar. You, as System 
Administrator, can use tar to copy your own files or those of any user. A user can 
also use tar, but only to copy those files to which he or she has access. 


You can also use tar to restore files and directories. For more ways to use tar, see 
the help page for tar (if you have installed the help files). 


In the following example, you back up and restore the namelist file you created 
earlier. 


backing up with tar 


1. 


Log in as root. Insert a formatted floppy diskette or cartridge into Drive @, 
and type: 


tar cvfk device number of Kbytes namelist | ENTER 


cvfk is the command variant; device specifies where the files will be copied. 
Specify /dev/rfd@ for floppy Drive @, /dev/rcd®@ for cartridge Drive @. If you 
are using a single-sided diskette, the number of Kbytes is 608. If you are 
using a double-sided diskette, the number of Kbytes is 1224. If you are using 
a 10 megabyte removable cartridge, the number of Kbytes is 9760. If you are 
using a 20 megabyte removable cartridge, the number of Kbytes is 20896. 
The r preceding fd@ tells XENIX to copy raw data, which is a faster way to 
copy. You can copy several files or directories at the same time. Simply space 
between each name. If you use a directory name, tar copies everything below 
that name in the hierarchy. 


When the file is copied, the screen shows: 
a namelist x tape blocks 


The letter a indicates that the file has been added. x is the number of tape 
blocks. 


restoring with tar 
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Place your backup floppy diskette or cartridge in Drive @ and type: 
tar xvf device namelist | ENTER 
xvf is the restore command variant. Device is the same as described above. 


When the file is restored to hard disk, the screen shows: 


x namelist, x bytes, x tape blocks 
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printing 


With XENIX you can print a file you created in XENIX, you can print a file you 
created with an applications program, and you can create texi and print it 
immediately. You print using the XENIX command Ipr. 


from the console 


You can log in either as root or as a user to print from the console. Log in now as 
a user. 


printing a file 
First, print the namelist file you created earlier. 
1. At the prompt, type: 

lpr phonebook/namelist 


2. The namelist file prints on your line printer. When it is finished, your user 
prompt appears on the screen. 


XENIX automatically prints 66 lines per page. 


Note: You can print a file you create with an applications program by following 
the above instructions. Be sure to enter the filename correctly. 


printing text 
You can use XENIX as a kind of typewriter; that is, you can enter text and print it 


on your printer. When you enter text in this way, however, you do not create a file. 
For this example, write a memo. 


1. At your user prompt, type: 


lpr [ENTER 


2. Now type anything you want. End each line by pressing | ENTER |. When your 
memo is complete, type d, and your memo is printed on your line 
printer. 


from a terminal 


If you have a printer connected to a terminal, from the terminal you can print on 
its printer or you can print on the system printer. 


using the system printer 


To print on the system printer, at the user prompt, type: 


lpr filename 
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XENIX places the file in the system spooler and prints it on the system printer when 
it is available. 


using the “local” printer 
The local printer is the one connected to a terminal. 


If any of your users have a DT-1, it must be modified before it can be used for 
local printing. Consult your Radio Shack Computer Center representative about this 
modification. 


If any of your users have a DT-100, it needs a Tandy DT-100 Terminal Interface 
(Cat. No. 26-1198) before it can be used for local printing. 


Before doing local printing from a terminal, be sure the printer is properly 
connected and that it is online. To print locally, type: 


local Ipr filename | ENTER 


lf the printer does not start or if it stops during printing, check the printer before 
pressing any key. If the printer goes offline, the system waits for it to come back 
online. Correct the problem that caused the printer to go offline and place the 
printer back online. The printer then continues from the point at which it went 
offline. 


Warning: While doing local printing, do not press any key on the keyboard unless 
your terminal screen displays a message asking you to do so. Do not attempt to 
terminate the printing process by pressing or any other key. Inadvertently 
pressing a key may cause extra characters to be printed on the printer and may 
cause the printer, the terminal, or both to end processing. 


XENIX automatically sets the size of the form on which you print to 66 lines (6 
lines = 1 inch). This does not mean that you actually print 66 lines of text on the 
form. The printer prints whatever you have specified and then goes to the top of the 
next form. From the top of the form to the bottom is 66 lines. 


You can change the number of lines per form by using the following command: 


local Ipr -F “p=x” filename | ENTER 


-F tells XENIX that you want to change the size of the form. For x, substitute the 
number of lines you want per form. For example, to print checks or invoices that 
are 30 lines (5 inches) from top to bottom, type: 


local Ipr -F “‘p=30” filename | ENTER 


Note: Using -F with Ipr is not a way to paginate. You are not specifying the 
number of text lines on a page, but rather the number of lines from the top to the 
bottom of a form. Do not attempt to use -F as a paginating device. lt will not work 
as such. 


lf a user wishes to be able to print locally all the time, you can add the following 
line to the user’s .profile file: 


PRINTER =local;export PRINTER 


Now, when the user logs in, he or she is set to do local printing and need not use 
the local command to do so. Using lpr means printing on the local printer. 


Note: To use local printing with applications programs, see the instructions in the 
manual that comes with the program. 


+, 11 


using ed 


When you add terminals to your multiuser XENIX system, you will need to edit, or 


change, some existing files. To do this, you use the line editor, ed. 


In this chapter, you learn how to use ed. 


creating a file 


1. Login as a user and at the prompt, type: 


ed [ENTER | 


Your screen now shows the ed prompt, the asterisk (*). 


2. At the prompt, type a [ENTER |, and you are ready to begin entering, or 
appending, text. Type: 
ere And Olaf who on bended knee 
E Did almost ceaselessly repeat: 


(If you know the rest of this quote, you can also enter it.) 


3. When you are through entering text, type | ENTER | to end the last line. At the 


beginning of the next line type a period (.) and [ENTER |. The screen again 
shows the ed prompt (*). The period tells ed that you have finished 
appending. 


While you are entering text, it is kept in a special work space called a 
“buffer.” To save this text as a file, at the ed prompt type: 


w Olaf | ENTER 


4, The w copies the file and saves it as a file named “Olaf.” Your screen shows 


59, the number of characters in the file Olaf. 


5. Now end, or quit, your editing session. At the ed prompt, type: 


q [ENTER | 


Your screen now shows the user prompt. 


displaying the contents of the editing buffer 


1. To reenter the editor and to see the contents of the file you just created, type: 
ed Olaf 
2. ed displays: 


— 59 
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3. To display the contents of the file, type: 
1,$p 


4. The screen shows: 


And Dlaf who on bended knee 
Did almost ceaselessly repeat: 


(Did you complete the quote? If so, your third line also appears!) 


Typing 1,$ tells ed to start displaying at Line 1 of the text and to display 
through to the last line ($). To display only the last line, type: 


$ 
To display any single line, type the line number and | ENTER |. You need not 
type p. 


5. | You can move back and forth among lines quickly by typing either a plus (+) 
or a minus (-) and [| ENTER |. A plus displays the next line in the file, and a 
minus displays the previous line. To display the current line, type a period 


and | ENTER |. 


substituting text in the editing buffer 
You can delete portions of a line and substitute other letters or words. For example, 
let's change the word ‘ceaselessly’ to “unceasingly” in Line 2 of the Olaf file. 
1. Type: 


2s/ceaselessly/unceasingly/ | ENTER 
2. To verify that the substitution was made, type: 


p [ENTER 
The screen shows: 


Did almost unceasingly repeat: 


In Step 1, 2 is the line number, and s tells ed to “substitute.” The text to 
substitute for and the text to substitute are separated by slashes. 


deleting text from the editing buffer 
You can delete a portion of a line, or you can delete an entire line or several lines. 


deleting a portion of a line 


1. You use the s command to delete only part of a line, that is, a character or a 
string of characters. For example, delete the word Olaf from Line 1 of the file 
Olaf. Type: 


1s/Olat// 
2. Now display the line. Type: 


1 | ENTER 
The screen shows: 


And who on bended knee 
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deleting lines 


1. You use the d command to delete a single line or several lines. To delete Line 
2 from the file Olaf, type: 


2d [ENTER | 


2. Display the contents of the file to verify that Line 2 is deleted. Type: 


1,$p | ENTER 
3. The screen shows: 


And who on bended knee 


Note: To remove the entire contents of a file you create with ed and write to a file, 
you use the rm command. See Chapter 5 for instructions. 


undeleting lines 


1. You use the u command to undelete the last line deleted. To undelete Line 2 
from the file Olaf, type: 


u [ENTER | 


2. Display the contents of the file to verify that Line 2 has been restored to the 
file. Type: 


1,$p [ENTER 
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Your Tandy XENIX system consists of 1 computer and as many as 5 terminals. As 
System Administrator, you are responsible for connecting the terminals to the 
computer, installing the terminals, and making users. 


In this chapter are instructions for connecting the DT-1 and the DT-100 to any of 
the following computers: Enhanced Model |1, Enhanced Model 12, Model 16, 
Model 16b, and Tandy 6000. 


To connect the DT-1 to your computer you need 2 items—a DB-25 Cable (Cat. No. 


26-4403) and a Null Modem Adapter (Cat. No. 26-1496). Before you begin, be 
sure that your system is shut down properly and that the computer and all 
peripherals are off. Connect the DT-1 according to the instructions in Data 
Terminal Owner’s Manual. 


connecting the DT-1 to your computer 
1. Connect one end of the DB-25 Cable to the RS-232 jack in the DT-1. 


2. Connect the other end of the cable to the female plug of the null modem 


adapter. 

3. Connect the male plug of the adapter to Serial Channel A or B of your 
computer. 

4. If your computer requires it (see the owner's manual), insert a terminator plug 


into the unused serial channel. 


5. | Now power up your hard disk, your computer, and the DT-1. 


setting input-output parameters for the DT-1 


Before using the DT-1 with your computer, you must be sure the DT-1 is using the 
appropriate Input-Output parameters. To do this, you must be at the keyboard of 
your DT-1. 


1. To display the Input-Output parameters menu, type: 
CTRL | | SHIFT | | ENTER 


2. The screen shows: 
SET-UP 


TC? TCO EM1 EMG REV DTR DSR DCD 
g 0 ø g g 1 1 1 


STB O7E PAR WDL BR3 BR2 BR1 BRO 
g Ø G Ø g 1 g g 


ALF AWP F/H CT1 CTA 
1 1 B 1 g 
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3. The cursor is positioned below TC1. Change the pattern of @’s and 1’s to the 
following. As you change a character, the cursor moves to the next character. 
To move around the screen otherwise, use the arrow keys. 


00109001 @ 
00001001 
01001 


4. After you type the last 1, press | ENTER |. The DT-1 asks if you want to store 
the parameters permanently. Press Y. The screen shows: 


SET-UP STORED 
5. To leave the Set-Up Mode, type: 
CTRL | | SHIFT | | ENTER 


The menu leaves the screen, the buzzer sounds, and the cursor returns to 
home position. Your input parameters are stored permanently. Each time you 
power up your DT-1, it uses these parameters. 


For further information about Input-Output parameters, see Data Terminal 
Owner’s Manual, 


enabling the DT-1 


Before you can use the DT-1, you must enable it. Return to the keyboard of your 
computer and log in as root. 


1. If you connected the cable to Serial Channel A, type: 


enable tty01 


2. lf you connected the cable to Serial Channel B, type: 


enable tty@2 


Create a user directory and a password for the person who is to use this 
terminal and it is ready to access XENIX. (See Chapter 3 for instructions.) 


DT-100 


~Data Terminal Quick Reference Guide. 


- To connect the DT-100 to your computer you need 2 items—an RS-232 Cable 


(Cat. No. 26-1495) and a Null Modem Adapter (Cat. No. 26-1496). Before you 
begin, be sure that your system is shut down properly and that the computer and 
all peripherals are off. Connect the DT-100 according to the instructions in DT-100 


connecting the DT-100 to your computer 
1. Connect one end of the RS-232 cable to the DT-100 modem jack. 


2. Connect the other end of the cable to the female plug of the null modem 
adapter. 


3. Connect the male plug of the adapter to Serial Channel A or B of your 
computer. | 


4. lf your computer requires it (see the owner’s manual), insert a terminator plug 
into the unused serial channel. 


5. Now power up your hard disk, your computer, and the DT-100. 
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telling XENIX your terminal type 


In XENIX is a file called /etc/termcap. It contains some codes that identify various 
terminals. Your computer is automatically set to let you connect and use a 
maximum of 5 DT-1 terminals. When you connect and install another terminal, 
you must identify that terminal to XENIX. 


The code for your DT-100 is dt1@@. You let XENIX know your terminal type by 
listing it in a ftle called /etc/ttytype. To do this you use the XENIX line editor ed. 
(For a quick review of ed, see Chapter 11.) 


1. 


At the root login prompt, type: 
cat /etc/ttytype | ENTER 


The screen shows the following: 


trs16 console 

adds25 tty 

adds25 ttyée 

adds25 ttyé4 

addses ttyd@s 

adds25 ttyð6 
trs16 is your computer, or the console. adds25 is the code for the DT-1 
terminal. To identify your DT-100, you must change adds25 to dt100 tty01. 


Now use ed to change this line. Type: 

ed /etc/ttytype 
The screen shows the number of characters in this file. 
Type: 


2s/adds25/dt100/ (Serial Channel A) 
3s/adds25/dt1 00/ (Serial Channel B) 


w | ENTER 


The screen shows the number of characters in the file as it now exists after 
being edited. 


Type q | ENTER | and your login prompt returns to the screen. XENIX knows 
that you are installing a DT-100. 


enabling the DT-100 


1. 


If you connected the cable to Serial Channel A, type: 


enable tty@1 


If you connected the cable to Serial Channel B, type: 


enable tty@2 


Create a user directory and a password for the person who is to use this 
terminal, and it is ready to access XENIX. (See Chapter 5 for instructions.) 


disabling terminals 


At times, you may need to disconnect a terminal. Before doing so, disable it. 
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If the terminal is connected to Serial Channel A, at the root prompt type: 


disable tty01 


If the terminal is connected to Serial Channel B, at the root prompt type: 


disable tty@2 [ENTER 


setting up remote terminals 


If you connect terminals to the computer with cables, as many as 5 terminals in 
the same location (room, floor, building) can use the same XENIX system. If you 
connect a computer and terminals with a modem, terminals at a distance (in 
another building, town, state) can use the same XENIX system via telephone lines. 


Connect the modem following the instructions in the manual that comes with the 
modem. Now you must inform XENIX that you are operating from a remote 
location, and you must set the baud rate so that it is compatible among computer, 
modem, and terminal. 


setting up the DT-1 for remote use 
1. At the computer, log in as root and edit the file /etc/ttys. To do so, type: 


cat /etc/ttys 


2. The screen shows: 


ger. 19console 
} B9ityot 
5 gIttyl2 
9SttyA4 
93ttya@s 
gƏttyß6 


3. You must change the 9 in Column 2 to a 3 in the line that identifies the 
terminal you are setting up for remote use. For example, to set tty@1 for 
remote use, type: 


ed /etc/ttys 
4. The screen shows the number of characters in this file. Now type: 
25/09/03/p 
5. The screen shows: 
a3ttyat 
6. Now type: 
w 


7. The screen shows the number of characters in the edited file. Type q | ENTER 
and your prompt returns to the screen. 


8. Now enable tty@1. Type: 
enable tty01 
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9. Atthe DT-1 you must now set the Input-Output parameters to correspond 
with the baud rate of your modem. For instructions, see ‘Setting Input- 
Output Parameters for the DT-1,” earlier in this chapter. 


lf you are using 300 baud, set the Input-Output parameters to the following 


pattern: 
001000180 
90000166 
0100601 
If you are using 1200 baud, set the Input-Output parameters to the following: 
00100010 
00000110 
01091 


10. Now when you log in to XENIX, the system switches between 1200 and 300 
baud until it receives a rate that is compatible. Your screen may show 
“garbage,” a configuration of random characters. If this happens, press 
[ENTER |. If your screen shows garbage again, press until the login 


prompt appears. 


setting up the DT-100 for remote use 


Connect the modem following the instructions in the manual that comes with the 
modem and the instructions in DT-100 Data Terminal Quick-Reference Guide. 
Install the terminal and edit the /etc/ttytype file. (See the instructions above under 
“Telling XENIX Your Terminal Type.”) Now edit the /etc/ttys file to let XENIX know 
you are setting up the terminal for remote use. (See the instructions above under 
“Setting Up the DT-1 for Remote Use.’’) 


The DT-100 parameters are set up by default to be compatible with XENIX. See 
DT-100 Data Terminal Quick-Reference Guide for instructions on how to select 
these default parameters. 


terminal setup problems 


When you enable a terminal, the device on the other end of the line should not 
respond to the “login:” prompt by itself unless it really intends to log in. If the 
cable is connected to a modem which always echos anything that is sent to it, the 
computer and the modem may continuously send characters to each other. This 
slows down the system and creates unnecessary disk drive activity. This is called 
“thrashing.” 


A long cable with nothing connected on the other end can pick up noise. This 
noise appears as a continuous stream of input characters. A DT-1 terminal with the 
power off can also generate a continuous stream of characters. To fix this problem, 
leave the DT-1 power on, or disconnect the cable from the computer. 


To prevent noisy lines from greatly interfering with system performance, XENIX 
keeps track of how often it must invoke getty, the “login:”” prompt program. If 
XENIX must restart getty too frequently, it will disable the troublesome line and 
then send a mail message to root that is similar to this: 

From root Thu Jul 18 13:15:42 1986 


Subject: init: Thrashing problem on line ttyé@4. 
This line will be disabled 
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The message indicates the time that XENIX disabled the line, and which line was 
disabled. If you receive a mail message like this one, attempt to correct the 
thrashing problem, and then re-enable the line. 


if a terminal stops working: 


1. Check the cables, power cords, and power switches to see that everything is 
properly set up. 


2. At the console, log in as root, and invoke the xmai/ program. Read any mail 
that was sent to root. If there is a problem with a terminal line, the system 
may automatically disable it. If you see a message similar to the following 
one in the mail, see Chapter 12: ‘Terminal Setup Problems’’: 

From root Jul 180 13:15:92 1986 


Subject: init: Thrashing problem on line tty@4. 
This line will be disabled. 


It is also possible that someone disabled the terminal line and forgot to re- 
enable it. See Chapter 12: ‘Enabling the DT-1" or “Enabling the DT-100.’’ 
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communicating with users 


As System Administrator you frequently want to communicate with users on your 
system. You may wish to inform them that you are about to shut down the system, 
or you may need to relate other information, such as announcements or reminders. 
XENIX lets you do this with /etc/motd (message of the day) or with wall (write all). 
If you are connected to a terminal by modem, you can also send messages and 
transfer files with a utility called cu. 


/etc/motd 


lf you place information in the message-of-the-day file, the screen displays it 
whenever a user logs in. You use ed to write in this file. 


1. Log tn as root and type: 


ed /etc/motd | ENTER 


2. Your screen shows the number of characters in the file and the ed prompt (*). 
(If the file contains information, delete it before writing a new message of the 
day.) To write a new message, type: 


a 

Today is Beethoven’s birthday. 

The Tandy String Quartet will present 
the Opus 18 quartets in the 9th floor 
Conference Room, beginning at 4:00 PM. 
A wine and cheese hour will follow. 
Everyone is invited. 


Your screen now shows the ed prompt. Type: 


Ww | ENTER 
Your screen shows the number of characters in the file and the ed prompt. 
Type: 

q | ENTER 


3. Now, whenever users log in, this message appears just before their login 
prompt. 


wall 


wall connects you immediately with all users on the system. You should use it only pred 
in an emergency since it interrupts whatever is occurring at the time. It is a handy | 
tool, however, for notifying users of a critical situation, for example, a shortage of 

disk space. 
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To use wall, log in as root and type: 


wall | ENTER 
Shortage of available disk space. | ENTER 


Please clean up files quickly. 
d 
Notice that you end your message by typing | CTRL] d. The screen shows: 


Broadcast message from root 
Shortage of available disk space. 
Please clean up files quickly. 
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cu is a XENIX utility that lets you communicate with other systems. The systems 
can be connected manually, that is, by cable, or they can be remote, that is, 
connected via modem. 


Regardless of how the systems are connected, you must disable the channel you 
are using (tty@1 or tty@2) before you call up another system. To do so, use the 
disable command. For example, to disable channel tty@1, type from the root 
prompt: 


disable tty@1 


When you are through using cu, you may wish to allow users to log in through 
that channel. If so, you must enable the channel once again. To do so, use the 
enable command from the root prompt: 


enable tty01 


You may find it more convenient to reserve a channel for dial-out by simply leaving 
it disabled and leaving the other channel enabled so that others can call in. 


calling up a manually connected system 


At the system prompt, type: 
cu wait -s baud rate -a /dev/null -1 /dev/channel 


The baud rate must be the same for both the sending and the receiving devices. 
The possible baud rates are: 


100, 15@, 300, 1200, 2400, 4800, 9600 


/dev/null indicates that you are not connected via modem. channel is the serial 
channel to which the cable is connected at your terminal. If you are connected 
through Channel A, replace channel with tty01; if you are connected through 
Channel B, replace channel with ttyð2. 


For example, if you are sending and receiving at 1200 baud and are connected 
through Channel B, type: 


cu wait -s 1200 -a /dev/null -1 /dev/tty02 


calling up a remote system 
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cu phonenumber -s speed 

You can, however, select the dialout speed to your modem. 

To select a dialout speed of 1200 baud (and 1200 baud only), type: 
cu phonenumber -a /dev/cua#.1200 -s 1206 


phonenumber is the desired phone number. # is @ if you are dialing out on ttyð1; 
it is 1 tf you are dialing out on ity@2. 


To select a dialout speed of 300 baud (and 300 baud only), simply substitute 300 
for 1200 in the above command line. 


You can use cu to transfer only ASCII files; you cannot transfer binary files with cu. 


You may lose characters during a file transfer if your communication lines have 
noise. To correct this problem, you may need to place the call again or lower the 
baud rate. 


using cu 


If you wish everyone on your system to be able to use cu, change the permissions 
on the device file that corresponds to the serial channel you are using for cu to 
include read and write permissions for everyone. See Chapter 6 for instructions on 
how to set and change permission settings. 


You Can use cu to access a network, call up a bulletin board, or communicate 
with a terminal on another system. You do not use it to communicate with users 
on your XENIX system. The hello program ts used for that. 


After you connect, cu runs as two processes—send and receive. You communicate 
by transferring files between 2 systems. The send process reads what you type at 
the keyboard, or a file you previously created, and passes it to the other system. 
The receive system reads what is transmitted from the other system and displays it 
on your screen. 


If you are connecting to a bulletin board or a network, after you connect and log 
in you follow the communications protocol established by the system you are 
calling. 


If you wish to communicate with a terminal on another XENIX system, you can use 
the procedure that follows. The procedure for initiating and terminating 
communication with cu is the same regardless of the device you wish to access. 


sending and receiving messages 


1. After you type the cu command, the screen displays a message that you are 
connected. Press | ENTER | and log in at the prompt. To send a message, at the 
shell prompt type: 


hello user 

You can now type the message 

you want to send. Be sure to 

end each line you type by pressing the 
<ENTER> key. To end a message, type 
<CTRL> d at the beginning of a new line. 


[CTRL] d 
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2. After you type d, the other system’s prompt appears on the screen. To 
exit cu, type: 
: 
Note: To obtain the tilde (°) at the console keyboard, type 6. 
3. | Now your screen shows your XENIX shell prompt. 


When you use hello to send a message, that message immediately appears on the 
receiver's screen if the system is in use. If the receiver wishes to respond, he or she 
does so using the hello command as shown in Step 1 above. If the receiver does 
not wish to respond, he or she can ignore the message and continue with whatever 
task was at hand. 


transferring files 


You can use cu to communicate with another XENIX system and with a non-XENIX 
system. You can transfer files, however, only between 2 XENIX systems. You cannot 
use the following commands unless both systems are operating with XENIX. 


When you transfer a file with cu, you simply copy it onto another XENIX system. 
You can copy it with the same name or with another name. To copy a file, you 
must be in the directory where the file exists. 


To copy a file from your system to another XENIX system, at the other system’s 
prompt type: 


“%put filename | ENTER 


This command copies a file from your system to the other system; its name 
remains the same on both systems. If you wish to copy it and rename it on the 
other system, type: 


“%put filename newfilename | ENTER 
To copy a file from another system onto your system, type: 


“%take filename | ENTER 


To copy a file from another system onto your system and rename it on your system, 
type: 
“%take filename newfilename | ENTER 
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adding file systems 


As you work with your XENIX system, you may find that you need more space than 
is available on the primary hard disk. XENIX notifies you when the primary hard 
disk is full by displaying the following message on the console: 


No space on dev 1/33 
You can then decide whether to delete some files or to create additional file 


systems. If you want additional file systems, you can create them either on floppy 
diskettes or on an additional hard drive. 


creating file systems on floppy diskettes 


1. Format the diskettes you need according to the instructions in Chapter 4. 


2. Now you can create a file system on the diskette. If you have just used 
fy diskutil to format the diskette, boot XENIX by pressing the reset switch. Now, 
od insert a formatted diskette in Drive @, and log in to XENIX as root. 


3. At the root prompt, type: 
makefs 


4. Your screen shows the following menu: 


Make a File System on... . 


Type 1 a single-sided floppy 
2 a double-sided floppy 
3 a hard disk 
4 a disk cartridge 
q to quit 


> Enter Number: 


5. Type 1 if you are using single-sided diskettes; type 2 if you 
are using double-sided diskettes. The screen shows: 


On which floppy Drive (6-3)? 
6. Type O | ENTER}. The screen shows: 


Insert formatted disk in Drive @ and press ¢ENTER> 


7. When the file system is created, the screen shows: 


Press “<ENTER> to continue 


The menu reappears on your screen. If you do not wish to Create another file 
system, type q | ENTER |. Your root prompt returns to the screen. 


; 
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8. Before you can access your new file system, you must mount it. That is, you 
must attach it electronically to your original XENIX file system. XENIX has a 
special directory available for this called /mnt. To mount your new file 
system, type: 


/etc/mount /dev/fd@ /mnt 


9. Your new file system is ready to use, and you can work on it just as you do 
on the original file system on your hard disk. 


10. When you are through working on your new file system, you must unmount 
it before removing it from the drive. To do so, at the root prompt type: 


/etc/umount /dev/id@ 


Note: When you use the shutdown command to halt the system, your 
system’s filesystems are automatically unmounted. 


creating file systems on secondary hard disks 


Connect the hard disk to the computer according to the instructions that 
accompany the hard disk. Then, power up your computer and format the hard disk. 
Follow the format instructions in Chapter 1. Be sure to enter the track and head 

information from your Media Error Map as instructed. If this is your second hard 
disk, XENIX refers to it as Hard Disk 1. Be sure to enter it as such when XENIX 

asks for the hard drive number during formatting. 


1. When the format is complete, press the reset switch, and log in to XENIX as 
root. At the root prompt, type: 


makefs | ENTER 


2. The screen shows the following menu: 


Make a File System on . . . 
1 a single-sided floppy 

2 a double-sided floppy 

3 a hard disk 

4 a disk cartridge 

q to quit 


Type 


> Enter Number: 


3. Type 3 ( ENTER]. The screen shows: 
On which hard drive (48-3)? 
4, Type 1 | ENTER |. The screen shows the following: 


Disk has xxx cylinders. 

Disk has x heads. 

Disk has xx tracks reserved for bad track mapping. 
Making a file system of xxxxx blocks on /dev/hdi. 


5. When the file system is created, the screen shows: 


Press <ENTER>D to continue 


6. Press | ENTER |, and the menu returns to the screen. At the menu, type q 
ENTER |, and your root prompt reappears. 


7. To mount your secondary hard disk, type: 


mkdir /hd1 
/etc/mount /dev/hd1 /hd1 
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Your secondary hard disk must be mounted before you can acccess and use 
it. If you will be using it regularly, you can or create the /etc/rc.user file to 
include mount. Then it is automatically mounted when you boot up XENIX. 


To do so, add the following line to the /etc/rc.user file: 
/etc/mount /dev/hd1 /hd1 


8. In most cases, you will use the secondary hard disk regularly and will not 
want to unmount it. You must unmount it, however, before doing File System 
Check. (See “Restoring a Primary Hard Disk with 2 or More Floppy Drives’ 
in Chapter 8.) 


To unmount, type: 
/etc/umount /dev/hd1 


creating file systems on cartridge 


1. At the root prompt, type: 


makefs | ENTER 


2. Your screen shows the following menu: 


Make a File System on... 


a Single-sided floppy 
a double-sided floppy 


Type 1 
2 
3 a hard disk 
4 
q 


a disk cartridge 
to quit 


> Enter Number: 


3. Type 4 [ENTER]. The screen shows: 


On which cartridge Drive (@ or 1)? 


4. Type @[ ENTER |. The screen shows: 
Do you wish to format a cartridge? CY/N): 


5. Type Y [ENTER]. The screen shows: 


About to format a cartridge in Cartridge Drive @ 
Warning! Any existing data will be destroyed. 
Press <BREAK> to prevent this, or insert a disk 
cartridge in Drive B and press ENTER to continue: 


6. When the file system is created, the screen shows: 


Press <ENTER> to continue 


The menu reappears on your screen. If you do not wish to create another file 
system, type q | ENTER |. Your root prompt returns to the screen. 


7. Before you can access your new file system, you must mount it. That is, you 
must attach it electronically to your original XENIX file system. XENIX has a 
special directory available for this called /mnt. To mount your new file 
system, type: 


/etc/mount /dev/cd@ /mnt | ENTER 
You can also use /cdmnt@ instead of /mnt. 


8. Your new file system is ready to use, and you can work on it just as you do 
on the original file system on your hard disk. 
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9. When you are through working on your new file system, you must unmount 
it before removing it from the drive. To do so, at the root prompt type: 


/etc/umount /dev/cd@ 


Note: When you use the shutdown command to halt the system, your files 
are automatically unmounted. 


Notes About Disk Cartridges: XENIX locks disk cartridges while they are in use. 
This is to prevent anyone from removing a disk while it is in motion. During this 
time, the cartridge release button is ignored. 


When the drive is no longer in use, XENIX unlocks the drive so you can remove 
the disk cartridge. 


If you are using the disk cartridge as a mountable filesystem, XENIX keeps the drive 
locked until you unmount the filesystem. Note that if you improperly shutdown 
your XENIX system or if it crashes with the cartridge mounted of in use, XENIX 
does not unlock the drive. To unlock it, press the reset switch. XENIX unlocks the 
drives at the Xenix Boot> prompt so you can remove the cartridge disk. 
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maintaining the file system 


As System Administrator, you are responsible for monitoring disk space and for 
ensuring the consistency of files. Maintaining adequate disk space and consistent, 
or “clean,” files is essential to an efficient system. When the disk runs out of 
space, your system can no longer function. If your file system is inconsistent, or 
“dirty,” you can lose files or even bring your system to a halt. 


Checking disk space and files is part of your regular routine as System 
Administrator. 


checking disk space 


XENIX reports disk space in blocks. A 15-megabyte hard disk has 31212 blocks; a 
35-megabyte hard disk has 69632 blocks. A minimum of 2057 blocks is always 
reserved as a “swap” area. XENIX uses this space to temporarily store information 
on running programs. We recommend that you always keep 15% of your blocks 
free. 


With this information and some simple arithmetic, you can arrive at the maximum 
number of blocks to use. For example, if you have a 15-megabyte hard disk, you 
can use 24474 blocks. 


You find out about disk space, number of files, and who has access to them by 
asking XENIX. 


how much disk space is free? 


1. To find out how many blocks are free on your root file system, or your 
primary hard disk, at the root prompt type: 


df | ENTER 
2. Your screen shows: 


/ C/dev/root): xxxxx blocks xxxx i-ņnodes 


Of course, the number will reflect the blocks available on your particular 
system. 


3. To find out how many blocks are free on your secondary hard disk, type: 


df /dev/hd1 


4. Your screen then shows the number of available blocks. 
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how many blocks are allocated to what files and users? 


1. 


To find out specific information about how many blocks are owned by each 
user on a particular disk, type: 


quot —f /dev/hd@ 
Note: In this case, you are asking about the primary hard disk (hdQ). 


Your screen shows something similar to the following: 


/dev/hdg@: 
8486 673 bin 
4654 148 root 


651 77 sys 
38 29 pat 
3 3 donna 
2 2 bc 


The number in Column 1 is the total number of blocks used by the files. The 
number in Column 2 is the number of files. Column 3 identifies the login 
name of the owner. 


how many blocks are used by individual directories? 


1. 


To find out how many blocks are being used by everything below your 
current directory, type: 


du ( ENTER | 


The screen shows a list of directories, subdirectories, and files and the 
number of blocks used by each as well as a subtotal of individual directories. 


You can also specify a directory. When you need more space on the hard 
disk, it is helpful to know what user files are consuming how many blocks. 
Then, if they are not essential, you can delete them and have more available 
space. For example, to find out how many blocks are in /usr/pat, type: 


du /usr/pat | ENTER 
Your screen shows something similar to the following: 
4 /usr/pat/scripsit 
3 /usr/pat/projects 
1 /usr/pat/schedule 


2 /usr/pat/be 
12 /usr/pat 


Column 1 shows the number of blocks, and Column 2 shows the directory 
name. 


checking files 
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When you boot up XENIX, you may see a message saying that the file system 
needs cleaning. XENIX also asks if you want to clean the system. You always 
respond yes. Then XENIX runs a program called fsck (file system check). 


Inconsistent files can result from shutting down the system improperly or from 
hardware problems such as a faulty drive. If you suspect file problems, you can run 
fsck yourself. Before doing so, make sure the file system is not mounted. If you are 
in multi-user mode, it may be necessary to have some or all of the users log off the 
system to prevent accesses to the file system you want to clean. 
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1. To check the files on your secondary hard disk, log in as root and at the root 
prompt, type: 


fsck ~y /dev/hd1 


2. Your screen shows each of the 5 checking phases and then reports the 
number of files, the total number of blocks, and the number of free blocks as 
follows: 


/dev/hd1 
** Phase 
+*+ Phase 
** Phase 


- Check Blocks and Sizes 
- Check Pathnames 

Check Connectivity 

** Phase - Check Reference Counts 
*#* Phase - Check Free List 

xxxx files xxxx blocks xxxx free 


nA WYN > 
) 


XENIX then tells you if the root structure was “okay” or if the file system has 
been modified. 


fsck warns you if you attempt a file system check on a disk that was not 
formatted by XENIX 3.0. This is a warning only. You may also see one of the 
following on the screen: 


free inode count wrong in superblk 
fix? yes 


free blk count wrong in superblk 

fix yes 
This is normal. Do not attempt to use this procedure on your primary or root hard 
disk. You must use the File Maintenance diskette to check a primary. 


monitoring processes 


Functions of the XENIX system—for example, editing, printing, copying—are 
known as “processes.” On your XENIX system you and your users can run several 
processes at the same time. It is frequently helpful to know what processes are 
currently running. 


1. To find out what processes are running at your console or terminal, at the 
root prompt type: 


ps [ENTER | 


2. To find out what processes are running on an entire multiterminal system, at 
the root prompt type: 


ps -e [ ENTER 


3. Your screen shows a report similar to the following: 


PID TTY TIME COMMAND 
2 co 1:87 -sah 
73 g1 2:49 tsh 
74 1 0:18 sh -c ps-e 
77 co 0:59 ps -e 


PID is the process identification number, which XENIX generates and uses. 
TTY is the terminal running the process (co is the console, or host computer). 
TIME is the tota! time the process has been running. COMMAND is the 
name of the process’s command or program. 
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XENIX. 
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You use the tx command to transfer files from TRSDOS-II formatted diskettes to 
XENIX. If you have files on TRSDOS-II SAVE formatted diskettes (-r option), you can 
also transfer them with the tx command. 


When you transfer files to XENIX, XENIX changes the filename to meet XENIX 
filename specifications. That is, XENIX changes all uppercase letters to lowercase 
and changes the slash (/) preceding the extension to a period (.). 


You can also use the tx command to display directory information for TRSDOS-II 
diskettes. 


Notes: 


1. When you transfer password-protected files to XENIX, only the user has 
ownership. 


2. The “r” permission must be set on the /dev files for the floppy drives (/dev/rfdn 
and /dev/fdbtn—n is 0,1,2, or 3, depending on the drive number). 


Important: XENIX can only read TRSDOS-II 4.x media. To transfer TRSDOS files to 
XENIX, use the FCOPY command to first copy the files to TRSDOS-II and then use 
the tx command to transfer the files to XENIX. 


The syntax for tx is: 
(a) tx :d options Tfspec | Twc Xdir 
(b) tx :d options Tfspec Xfspec 
(c) tx :d -f [Tfspec | Twc} 

The following options are available: 
-a absolute; copy files even if the file already exists 
-c do not convert uppercase letters in the filename to lowercase 
-f display the directory for the specified drive 
-| do not add a linefeed to TRSDOS-II VLR files | 
-p prompt the operator before each file is moved 
-r specifies that the source is TRSDOS-II SAVE media 
-5$ do not strip length byte from TRSDOS-I! VLR files 
-v verbose; display informative messages during copy 


-x converts Carriage returns to linefeeds (QAH to @DH) 
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Where: Tfspec = TRSDOS-I! file specification 


Twc = TRSDOS-II wildcard specification 

Xfspec = XENIX file specification 

Xdir = XENIX directory 

:d = the drive that contains the TRSDOS-I] diskette. :d is required. 


If you omit Xdir, the default is the current working directory (syntax example a). 


The options and drive number (:d) are position-independent. You may place them 
in any order on the command line (except within filenames). 


If you use a wildcard mask, you must enclose it in quotation marks. 


examples 


1. 


tx :@ 


copies all files from the TRSDOS-1| disketie in Drive @ to the current working 
directory of XENIX (default). 


. tx :@ ARMAIN/DAT . 


tx ARMAIN/DAT . :0 


copies the file ARMAIN/DAT from the TRSDOS-II diskette in Drive © to the 
current working directory (.). The XENIX filename is armain.dat. 


. tx :1 LEAOWN/IDX LEAOWN/DAT OWNER/DAT /usr/lease/owners -x 


tx -x LEAOWN/IDX LEAOWN/DAT OWNER/DAT /usr/lease/owners :1 
tx LEAOWN/IDX :1 -x LEAOWN/DAT OWNER/DAT /usr/lease/owners 


copies the files LEAQWN/IDX, LEAOWN/DAT, and OWNER/DAT from the 
TRSDOS-II diskette in Drive 1 to the XENIX directory /usr/lease/owners. The 
XENIX filenames are leaown.idx, leaown.dat, and owner.dat. 


XENIX converts any carriage returns in the files to linefeeds. (This is useful 
when you transfer BASIC source to XENIX.) 


. te :1 -c LEAOWN/IDX LEAOWN/DAT OWNER/DAT /usr/lease/owners 


tx LEAOWN/IDX LEAOWN/DAT OWNER/DAT -c /usr/lease/owners :1 
tx LEAOWN/IDX -c :1 LEAOWN/DAT OWNER/DAT /usr/lease/owners 


copies the files LEAOWN/IDX, LEAOWN/DAT, and OWNER/DAT from the 
TRSDOS-II diskette in Drive 1 to the XENIX directory /usr/lease/owners. 
Because you specified the -c switch, XENIX does not convert the filenames to 
lowercase. Therefore, the filenames are: 


TRSDOS-I] XENIX 
LEAOWN/IDX LEAOWN.IDX 
LEAOWN/DAT LEAOQWN.DAT 
OWNER/DAT OWNER.DAT 


. tx :3 “AR*” /usr/AR -pav 


tx -p -a -v :3 “AR*” /usr/AR 
tx “AR#*"" /usr/AR :3 -apv 


displays all files on the TRSDOS-II diskette in Drive 3 that match the wildcard 


` mask AR#*. Because you include the -p option, XENIX asks: 


copy ? 
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To copy the TRSDOS-II file into the XENIX directory /usr/AR, type y ( ENTER]. If 
you do not wish to copy the file, type n | ENTER |. 
Because you specified the absolute switch (-a), XENIX does not prompt if the 


destination file already exists. XENIX does display informative messages, 
however, since you specified the -v switch. 


. tx :0 -f 


displays directory information for every file on the TRSDOS-II diskette in 
Drive ð. ` 


tx :@ -f -r 


displays directory information for every file on the TRSDOS-II SAVE diskette in 
Drive @. 


. tx :3 INIT/* -f 


displays directory information for all files matching the wildcard mask INIT/* 
found on the TRSDOS-II diskette in Drive 3. 


. Wildcard Examples 


The wildcard character * (asterisk) matches zero or more occurrences of any 
legal filename character, including the slash (/). 


The wildcard character ? (question mark) matches only 1 occurrence of any 
legal filename character, including the slash (/). 


For example, assume you have the following files in the directory: 


TEST TEST TEST/DAT 
TESTA/DAT TEST1/DAT TEST/C 


The wildcard mask ‘’TEST*’’ matches all these files. XENIX, which does not 
follow TRSDOS-II wildcard conventions, does not recognize extensions and, 
therefore, considers the extension part of the filename. 


The wildcard mask “TEST?” matches only the file TEST1, because the question 
mark tells XENIX to match only one letter. Filenames with extensions are too 
long to match this wildcard. 


The wildcard mask “‘TEST?*’’ matches the following files: 


TEST TEST/DAT TES TA/DAT 
TEST 1/DAT TEST/C 


The file TEST does not match because the question mark must match at least 1 
character. 


Note: You must enclose in quotation marks any filename that contains the 
wildcard mask characters (* or 2). 


error messages 


Unknown option found You used an illegal option. 


Multiple drive specification You specified more than 1 device type. 


[Hegal drive unit number You specified an illegal drive number. Drive numbers 
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Drive number not found on the command line You did not specify a source drive 
number in the command line. 


Directory Xdir does not exist You specified a directory name that does not exist 
in the XENIX file system. 


Filestat failed on Tfspec This is an internal error. XENIX opened the file but 
could not read the file status. 


Filename Xdir is not a directory You specified as a directory a XENIX file. 


75 


18 


what to do if... 


Following the instructions in this manual will help to ensure that your system runs 
smoothly and functions efficiently. On occasion, however, you will encounter 
problems. This chapter lists some of the more common ones and what you can do 
about them. 


your printer jams 


Your printer will come to a halt if it needs a new ribbon or if the paper is not 
feeding properly. If it should stop, however, and neither of these is the reason, try 
the following procedure. 


1. Log in as root. To find out what processes are currently running on the 
system, including invisible processes that XENIX itself is running, type: 


ps -ef | ENTER 


2. Your screen might show the following: 


UID PID PPID C STIME TTY TIME COMMAND 

root g g 12 Dec 31 ? 8:606 swapper 

root 1 g (j Dec 31 ? 6:51 /etc/init 

root 35 1 g 15:21:12 ca 8:803 -sh HOME</ PATH<:/ 
bin:/usr/bin 

root 41 35 24 15:23:57 co 68:92 ps -ef 

root 29 1 g 16:21:61 ? 6:80 /ete/update 

root 29 1 1 15:21:88 ? 68:809 /ete/cron 

cron 32 1 g 15:22:08 co 8:96 /usr/lib/Ipd 


The last column indicates that one of the processes currently running is the 
line printer daemon. lts identification number is 32, and it is running on the 
console, or host computer. 


3. To “unjam” the printer, you need to kil] the process, move to the printer file 
directory, and “unlock” the printer. To do so, type: 


kill -9 32 
cd /usr/spool/Ipd 
rm -f lock 


4. Now type: 
/usr/lib/Ipd 


The printer should begin to operate. In all probability, the printer wil! begin 
printing the file it was printing when the jam occurred. 


you forget your root password 
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ao 
1 


18/what to do if... 


a user forgets his or her password 


The user can select another password, and you, logged in as root, can change the 
password. See Chapter 3 for instructions. 


the system runs out of space 


You can delete some files and make more space (see Chapter 5), or you can create 
new file systems on another hard disk or on floppy diskettes (see Chapter 15). 


your file system is damaged 


You can restore the file system from your backup library. See Chapters 8 and 9 for 
Instructions. 


you lose the screen display 


Occasionally, you may be unable to call anything up on the screen. This can 
happen when a program stops prematurely as a result of an error, when you press 


BREAK |, or when you inadvertently type | CTRL | s. 


To restore the screen display, follow these steps. 


ee 1. Type | CTRL| q. (This restarts transmission from the computer if you accidentally 
es typed s.) 


2. Now press and simultaneously. 
If the screen is still blank, follow these steps. 
1. Type j. You may see an error message on the screen. If so, ignore it. 
2. Now type: | 
stty sane j 
Your screen display should return. 


you have a runaway process 


A runaway process is either a process you cannot stop (a program that continues to 
execute) or a continuous stream of unwanted characters that appears on the 
screen. A runaway process can be the result of user error or electronic 

malfunction. In either case, you can use the following procedures, in the order 
given, to try to terminate the process. 


1. Wait a while to see if the process will cease on its own accord, unless, of 
course, you know that the process is damaging files. 


2: Press | BREAK |. 
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lf you have another terminal on your system, use it to try to kill the process. 
At the other terminal, log in as root, and type: 


ps —e | ENTER 


The screen should show the processes currently running on all terminals. 
Determine the 1D number of the unwanted process. At the root prompt, type: 


kill —2 process ID 


Wait a few seconds. If the process does not stop, type: 


kill —1 process ID | ENTER 


Wait a few more seconds. If the process still does not stop, type: 


kill —9 process ID 


In all probability, this last command will stop the process. 


If you are running XENIX from the console and do not have other terminals, 
you may have to press the reset switch to stop a runaway process. Because 
this is an incorrect way to shut down the system, it may cause file 
inconsistencies. Therefore, use it as a last resort, and then clean the file 


system by responding Y to the prompt. 
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important files and directories 


This chapter contains listings of the most frequently used files and directories in the 
XENIX system. Many are required for proper XENIX operation, and you should not 
modify them or remove them. 


the root directory 


root (/) contains the following directories, which are required for system operation 
and should not be deleted: 


/bin XENIX command directory 

/dev device special directory 

/etc additional program and daia file directory 

/lost + found storage area for orphaned files recovered by the file 
system cleaning program 

/mnt mount directory (reserved for mounted file systems) 

/usr user home directories 

/imp temporary directory (reserved for temporary files created 
by programs) 

/lib contains a system date utility 


root also contains the following files, which are required for system operation and 
should not be deleted: 


/diskutil disk formatter program 
/xenix xenix system object code 
/z80ct! z8@ control program 


the /bin directory 


/bin contains the commands most likely to be used by anyone on the system. The 
following list contains a few of these commands. All commands in this directory 
are required. 


basename echo passwd su 

cp expr rm sync 
date fsck sh tar 
dump login sleep restor 
dumpdir mv stty test 
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the /dev directory 


the /etc directory 


the /mnt directory 


the /tmp directory 
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/dev contains special files that control access to peripheral devices, such as disks 
and printers. All files in this directory are required and must not be removed. 


/dev/console 
/devi|p 
/dev/mem 
/dev/null 
/dev/fdx 
/dev/hdx 
/dev/cdx 
/dev/txx 
/dev/root 
/dev/swap 
/dev/ttyxx 
/dev/tty 
/dev/cdx 


system console 

line printer 

physical memory 

null device (used to redirect unwanted output) 
floppy disk drives 

hard disk drives 

disk cartridge drives 

unbuffered interface to corresponding device name 
root file structure 

swap area 

terminals 

terminal you are using 

cartridge disk drives 


/etc contains miscellaneous system program and data files. All files are required, 
but you may modify some of them. 


The following files must not be removed or modified: 


/etc/mnitab 
/etc/mount 
/etc/mkfs 
fetc/tnit 


mounted device table 

for mounting a file structure 
for creating a file structure 
first process after boot 


The following files may be modified but not removed: 


/etc/passwd 
/etc/rc 
/etc/ttys 
/etc/termcap 
/etc/motd 


password file 

bootup shell script 
terminal setup 

terminal capability map 
message of the day 


The following directory contains files that may be modified but not removed: 


/etc/default 


defaults for various programs 


/mnt, /mnt@, /mnt1, /mnt2, /mnt3, /cdmnt@, and /cdmnt1 are empty directories 
that are reserved for mounting removable file systems. 


/tmp contains temporary files created by XENIX programs. The files are normally 
present when the corresponding program is running. If you terminate the program 
prematurely, the files may be left in /tmp. You may remove any temporary file that 
does not belong to a running program. 
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the /usr directory 


/usr contains the home directories of all users on the system. It also contains 
several other directories that provide additional XENIX commands and data files. 


/usr/bin contains more XENIX commands, which are less 
frequently used or are not essential for system operation 

/usr/lib contains more libraries and data files used by various 
XENIX commands 

/usr/spool -contains various directories for storing files to be printed 

/usr/tmp contains more temporary files. You may remove any 


temporary file that does not belong to a running program. 


/ust/adm contains data files associated with system administration 
and accounting 


log files 


Some directories contain log files that grow in size during normal system 
operation. You should truncate many of these files periodically to free disk space. 
(Use the command cp /dev/null filename.) Before doing so, however, be sure to 
take note of their contents. Some of these files can be espectally useful. 


For example, the /usr/adm/messages file contains a record of all error messages 
fo, sent to the system console. tf it shows an unusual number of disk error messages, 
Tat you might suspect a defective or misaligned drive. 


The following is a list of these files (by full pathname) and their contents. 


/etc/ddate date of the latest backups. Do not delete or 
truncate this file. 

/usr/adm/logouts users who were logged off by idle. 

/usr/adm/pacct accounting information 

/usr/adm/messages error messages generated by the system when 
Started 

/usr/adm/shutdown.log log record of each shutdown 

/usr/adm/wtmp user logins and logouts 


/usr/spool/at/past is a directory that contains a file for each use of the at command. 
You may remove files in this directory, but not the directory itself. 
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system defaults 


A system default is a condition that exists within your XENIX system when you 
install it. For example, when you first boot the system, the root password is 

| ENTER |. You changed this default when you established your own root password. 
(See Chapter 2.) 


Some system defaults you may wish to change; most, however, you will keep. 
Following is a summary of system defaults, the files affected, and how to change 
the defaults. You must be logged in as root to edit any files containing system 
defaults. 


Note: After you edit a file to change a default, the setting you establish remains in 
effect until you change it again. 


mkuser defaults 
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You use the mkuser program when you add users to the system. 


group and user id numbers 


The /etc/passwd file contains information about users, including login names and 
user and group identification numbers. XENIX automatically assigns a group 
number of 5@ to all users on the system and sequentially assigns each user a 
number above 200 when you add users with the mkuser program. 


If you work with more than 1 XENIX system and users want to transfer files from 
one system to another, then each user must have identical login names and 
identification numbers on every system. Each name and number must be unique, 


For example, harryo has an ID number of 206 on one system. He wishes to transfer 
some of his files to another system, but a user on that system already has the ID 
number 206. harryo must choose a new ID number not in use on any system 
involved in his file transfers. 


First, determine a unique ID number, and then edit the /etc/passwd file to change 
206 to the new number. Now, you must change the user ownership of each of the 
user’s files and directories from the old user ID to the new one. To do so, type: 


chown user name (directory or filename) | ENTER 


Follow the same procedure to change a group ID, but use chgrp instead of chown. 


profile file 


The mkuser program creates a standard .profile file for each user. You can change 
the parameters of this file by editing /usr/lib/mkuser.prof. Use ed to do so. 


fr 
t 
` 
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drive defaults 


Drive defaults concern which drives are mounted and what kind of floppy drives 
you are using. 


mounted drives 


| 

| 

Initially, only your primary hard disk ts mounted. You can mount and unmount 
additional file systems as you want to use them. You can create the /etc/rc.user file 
to include a mount statement. Then a secondary hard disk system is automatically 
mounted when you type d in the boot procedure. 


floppy drives 
To find out the system defaults for floppy drives, at the root prompt type: 


drive | ENTER 
Your screen should show the following: 


drive B: nodetect, wait, seekrate=@ 
drive 1: nodetect, wait, seekrate=@ 
drive 2: nodetect, wait, seekrate=@ 
drive 3: nodetect, wait, seekrate=9 


nodetect indicates that for Drives @, 1, 2, and 3 the door-open detection device is 
off. You can choose for it to be on by specifying detect instead of nodetect. 


wait indicates that XENIX is to wait for the drive motor to reach proper speed 
before attempting to read or write to the disk in the specified drive. You can also 
select nowait. 


seekrate =@ indicates that the speed at which the drive locates the track to read or 
write to is 3 milliseconds (3 ms). seekrate = 2 indicates that the speed is 10 ms. 
You can also set the seekrate at 6ms by specifying 1 and at 15ms by specifying 3. 


We recommend the following settings for the following types of floppy drives: 


Thinline detect, wait, seekrate = Ø 
Latch nodetect, nowait, seekrate = 3 
Pushbutton detect, nowait, seekrate = 2 


To change the drive settings, use the following format: 
drive number wait | nowait detect | nodetect rate=x 


You must type the command in this order even though when you display the drive 
specifications they are in a different order. For example, to change the defaults of 
Drive 3, type: 


drive 3 nowait detect rate = 0 
Now, verify that the change is made by typing drive | ENTER |. 


terminal defaults 


System defaults specify that you will use a console and 5 DT-1 terminals. This 
information is in the /etc/ttytype file. For instructions on how to change this file if 
you are installing a different kind of terminal, see Chapter 12. 
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Information on the status of terminals on your system ts in the /etc/ttys file. Display 
this file and you see which terminals are enabled and disabled. Initially, only the 
console is enabled. To enable other terminals, you use the enable command. (For 
instructions, see Chapter 1 2.) 


printer defaults 


The printer spooler produces a header page (banner) to separate sets of printer 
output. If you do not want the banner page, edit the file /etc/default/Ipd. Change 


the line 
banners = 1 
to 


banners = 
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tsh, or trsshell, is a special XENIX command level that uses TRSDOS command 
names. These commands perform the same functions as XENIX commands; so if 
you are comfortable with XENIX terminology, you can disregard them. 


If, however, you have been using TRSDOS and are more comfortable with 
TRSDOS terminology, you may want to use tsh commands. To do so, you must 
enter the trsshell. You can do this from the root prompt or from the user prompt. 


At either prompt, type: 
tsh 

The screen shows the trsshell prompt: 
tsh> 


At this prompt, you can use any command listed in this chapter or any XENIX 
command. 


Before you can log out of XENIX, you must exit the trsshell. To do so, type: 


exit | ENTER 


Or 


[CTRL] d 


The screen now shows your XENIX prompt. 


Note: If your login shell is trsshell, you need not exit trsshell before logging out. 
Type | CTRL | d to log out of the system. 


Following are the tsh commands and their syntax and function. You can use wild 
cards in any tsh command that lets you specify multiple filenames. 


again string | history-number 


Executes a previously executed command. You can specify the command by 
a search String or history number. If you type again without any options, tsh 
executes the last command entered. 


alias command comanda-line 
unalias command 


Maps a command name to another command line. This lets you give shorter 
or easier names to commands that you use often. If you omit command-line, 
alias displays the command line for that command. If you omit both 
command and command-line, alias displays the current lists of aliases. Use 
unalias to remove an alias. 
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auto command fine 


Creates or removes an automatic command that executes when you enter tsh. 


The command line is stored in the .tshrc file. This file executes when trsshell 
starts up. If the file doesn’t already exist, it is created. 


To cancel the auto function, type: 


auto | ENTER 


The automatic command line is removed from the .tshrc file. 


cd directory 
chdir directory 


Changes the current working directory to the specified directory. lf you do 
not specify a directory, your home directory becomes the current working 
directory. i 


cls 


Clears the screen and places the cursor beside the tsh prompt. 


copy file1 file2 


Copies file? to file2. If file2 is an existing file, the permissions and ownership 
do not change. If file2 is being created, the permissions and ownership are 
the same as the file being copied. 


Note: The copy command will not copy a file onto itself. 


device 


Displays a list of devices that trsshel! recognizes and their descriptions. You 
use the device names with the dismount, mount, restore, and save 
commands. 


copy file1 file 2 ... directory 


Copies multiple files into a directory. The filenames do not change. 


dir 


Displays an alphabetic list of the contents of the current directory. 


dir filename 


Displays, in long format, the specified file. You can specify multiple files. 


dir directory name 


Displays an alphabetic list of the contents of the specified directory. You can 
specify multiple directories. 


dir filename directory name 


Displays an alphabetic list of filenames and directory names; the list of 
filenames precedes the list of directory names. You can specify multiple 
filenames and directory names. 
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dir option filename 
dir option directory name 


You can use the following options with the dir command. 


-à 


-b 


Displays a list of all files. If you are logged in as root, XENIX 
assumes the -a option even if you do not specify it. 


Displays invisible character in octal notation. 
Sorts or prints files based on the creation date. 


Displays only the directory name, not its contents, if you specify a 
directory name. 


Displays the group 1D instead of the owner ID in the listing. 


Reverses the order of the sort, depending on the options you specify. 
For example, you may wish oldest date first or inverse alphabetic 


order. 
Displays size in blocks, including indirect blocks, for each entry. 


Sorts by time you modified the file or directory unless you specify 
the -c or -u options. 


Sorts or prints according to last access time. 
Displays a list of all files except for. and .. 


Displays the contents of al! subdirectories for the specified directory. 


dismount drive number -device 


Tells XENIX that you are removing a mounted file system on the specified 
drive and device. 


Execute the dismount command before removing the mounted disk. 


For information on the mount process, see mount. 


display filename 


Displays a full screen of text of the specified file. If the file contains more 
lines of text than the screen can show at one time, the following prompt 
appears at the bottom of the screen: 


If you are reading a file, and not a pipe, a percentage appears after ‘‘more.’ 


omor eS 


? 


This ts the percentage of the file (in characters, not lines) read thus far. 
To see the next line of text, press | ENTER |. To see the next full screen of text, 


press | SPACEBAR |. 


Below are the options available for use with the display command. You use 
them in the following form: 


-N 


display options filename 


specifies the number of lines the screen displays, or the window size. 
If you do not specify n, XENIX uses the entire screen. On a screen 
that can display 24 lines, the default window is 22 lines. Terminal 
characteristics and default window size are stored in the /etc/termcap 
file. 
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-5 “squeezes” extra blank lines from the screen. That is, if you have ta 
inserted more than one blank line between lines of text, that space is 
reduced to only one blank line. You use this option to increase the 
amount of pertinent information the screen displays. 


-r displays control characters on the screen. For example, if the file 
contains | CTRL | c, the screen shows: 


AC 
lf you do not specify the -r option, the screen does not display 
control characters that cannot be interpreted. 


-w waits to exit at the end of a file until you press | SPACEBAR |. If you do 
not specify -w, XENIX exits immediately. 


+linenumber displays the file, starting at the specified line number. 


When your screen shows the --more-- prompt, you have the options listed 
below. 


Note: In these options, n is always optional. If you omit n, however, XENIX 
uses 1. ae 


n | SPACEBAR displays the next n lines. If you omit n, the screen displays 
the next window of text. - 


D displays (scrolls) the next 11 lines of text. If you specified 
or n, the number of lines scrolled is n. 
d 
nz displays the next n lines and n becomes the new window ; 
size = 
ns skips n lines and then displays the full screen of text. 
nf skips n full screens and then displays the next full screen of 
text. 
q 
Q 
-q 
:Q exits display. 


displays the current line number. 


starts up the editor vi at the current line. 


< 


help command—displays a list of and describes all display 
commands. You can also use the question mark (?) to see 
this list on the screen. 


tcommand invokes a shell with command. The percent sign (%) in 
command is replaced with the current filename, and the 
exclamation mark (!) in command is replaced with the 
previous shell command. If no current filename exists, % is 
not expanded. The sequence \! is replaced by !. 


nin skips to the nth file in the command line (skips to the last 
file if n doesn’t make sense). 
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nip skips to the nth previous file in the command line. If you 
give this command while XENIX is displaying a file on the 
screen, then display goes to the beginning of the file. If n 
doesn’t amake sense, display skips to the first file. If display 
is not reading from a file, nothing happens. 


a displays the current filename and line number. 


repeats the previous command. 


You do not need to press | ENTER | after typing any of the above commands; each 
command executes immediately. Until you type the command character itself, you 
can cancel the numeric argument being formed by typing | CTRL | U. You can press 


BACKSPACE | to display the --more-- prompt. 


Whenever output is being sent to the screen, you can type 7 to stop the 
display. The screen then shows the --more-- prompt. You can then enter any of the 
above commands. Unfortunately, you may lose some output; any characters in the 
output queue are flushed when you type i 


This program sets the terminal to noecho mode so that output can be continuous. 
The screen does not show what you type, except for the slash (/) and the 
exclamation mark (!). 


do filename 


Executes the commands stored in filename as if they had been entered from 
the keyboard. You may nest do commands as deep as necessary or as the 
system memory allows. 


files directory name 


Lists in columns in alphabetic order all files in the specified directory. If you 
do not specify a directory, XENIX uses the current directory. You can specify 
multiple directories. When you do so, the screen shows the filenames first 
and then the directories. 


Directories are marked with a trailing slash (/), and executable files are 
marked with a trailing asterisk (*). 


Below are the options available for use with the files command. You use them 
in the following form: 
files options directory name 


-a Displays a list of all files. If you are logged in as root, all files are listed 
even if you do not specify the -a option. 


-b Displays invisible characters as /nnn (octal). 
-c Sorts and displays based on when the files were created. 


-d Lists only the directory name and not its contents if you specified a 
directory. 


-q Lists group ID and not owner ID. 


-r Reverses the order of the sort, depending on the options you specify. 
, For example, you can sort in reverse alphabetic order or by oldest date 
first. 
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-5 Lists size in blocks, including indirect blocks, for each entry. 
-t Sorts by time modified unless you specify the -c or -u option. 


-u Sorts and displays according to last access time instead of last 
modification. 


-x Displays in columnar format. Sorted material is displayed across rather 
than down. 


-| Forces a one-entry-per-line output format, for example, to a teletype. 
-A Displays a list of all files except those that have . and .. 
-C Forces multicolumn output. You use this to redirect output. 


-R Displays the contents of all subdirectories for the specified directory. 


free filesystem 


help 


Displays the number of free blocks on the specified file system. If you do not 
specify a file system, the screen shows the amount of free space on all 
mounted file systems. 


Displays an explanation of the help text and the notations used. To see a list 
of available subjects, type help * | ENTER |. To see the help text for a particular 
subject, type help subject (ENTER). 


To halt the display of the help text file, type q. 


history 


Displays a list of the previously executed commands. History assigns each 
command a number which can be used to re-execute it using the again 
command. History is set to display the last 20 commands. (See also again 
and set). 


kill filename 


lib 


Kills (removes) the specified file from a directory. The file is destroyed. You 
must have write permission for a directory to delete files from it. You do not, 
however, need read or write permission for the file to be able to delete it. 


You may specify multiple filenames. If you do so, XENIX prompts you for 
each file before the file is removed. Type y in response to the 
prompt. 


To delete a directory, type kill -r directory name. This deletes the contents of 
the directory and the directory itself. If you attempt to delete a file that is 
actually a directory, the screen shows an error message. 


Note: You cannot remove the file . . from a directory. 


Displays a list of the trsshell commands. 
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mount drive number device 
dismount drive number device 


Tells XENIX that a file system is now present on the specified drive and 
device. The file system's contents are made available in the /mntdrive number 
directory. *device specifies the type of device you are mounting (ss, ds, c10). 
See device for more information. If you omit device, tsh assumes floppy 
diskette. 


For example, if you place a XENIX diskette in floppy Drive @, you tell XENIX 
by typing mount @ [ENTER |. The contents of the diskette are made available in 
the directory /mnt@. You tell XENIX that you are removing the diskette from 


Drive @ by typing dismount 6 | ENTER |. 


The mount and dismount commands keep track of mounted devices. If you 
do not specify a drive number, the screen shows a table of currently mounted 
file systems. 


Note: You can only mount disks that contain XENIX file systems. If you 
attempt to mount a diskette that contains an alien file system, for example, 
TRSDOS, the command will fail and the system could require rebooting. 


move file? file2 
move file] file2... directory name 


Copies file? to file2. If file2 already exists, the existing permissions and 
ownership are retained. If it does not exist, the permissions and ownership of 
the source file become those of file2. 


You can copy multiple files into a directory with the second command line 
above. The filenames are not changed. 


Note: You cannot copy a file onto itself with the move command. 


print filename 


Queues the file for printing on the printer. You can place multiple filenames 
on the command line. 


Listed below are the options you can use with the print command. To use the 
options, follow this format: 


print option(s) filename(s) 


-T local Sends output to local printer regardless of how 
PRINTER was set. 


-T spooler Sends output to the print spooler for printing. 


-T Removes the file after it is queued. 

-C Copies the file so that no changes are made before it 
is printed. 

-m Reports by mail when printing is complete. 

-n Does not report by mail when printing is complete. 


This is the default. 


rename old.file new.filename 


Changes old.file’s name to new.filename. 
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restore drive number -d -device 


restore drive number -device filename .. . 


Restores files that were saved on diskette/cartridge to where they were 
originally..With the restore command, you may use multiple filenames or 
directory names. If you specify a directory name, the directory and its 
subdirectories, files, and their contents are restored. 


Device specifies the type of device from which you are restoring (ss, ds, c10, 
c20). See device for more information. 


-d is optional. If you specify -d, the screen shows a list of files on the 
diskette/cartridge. 


save drive number -device filename | -all 


set 


Saves files or directories and their contents to the disk in the specified drive. 
You may use multiple filenames or directory names. If you specify a 
directory, the directory and its subdirectories, files, and their contents are 
saved. 


Specify the -all option if you want to save the entire filesystem, including all 
mounted filesystems. 


Device specifies the type of device to which you are saving (ss, ds, c10, c20). 
See device for more information. 


-ss tells XENIX that you are using single-sided diskettes. -ds specifies double- 7 
sided diskettes. -c10 specifies a 10 megabyte disk cartridge and -c20 coy 
specifies a 20 megabyte disk cartridge. You must specify one of these device 


types. 


Displays a list of the internal option settings of tsh. 


set option 


Changes an internal option. The following options are available. 


verbose on | off If verbose is off, trsshell does not inform you of a 
command’s success or failure. 


retry on | off Enables or disables retry. If retry is on, the command line is 
converted to lowercase if trsshell is unable to execute a command. Trsshell 
then tries to execute the lowercase command line. 


prompt string Set the trsshell prompt to string. For example, to set the 


prompt to: 
cue> 
type: 
set prompt cue> 


term terminal-type Sets the user's terminal type by setting the environment 
variable TERM. 


history number Sets the number of commands that history remembers to 
number. 
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showhistory on | off If showhistory is on, trsshell displays each command and 
its history number as soon as you enter it. 


showstatus on | off If showstatus is on, trsshell displays the exit code if a 
command fails. 


showdir 
Displays the pathname of the current working directory. 


source file | 
Reads the command to execute from the specified file. Source reads and 
executes the commands as if you had typed them from the keyboard. Source 
differs from Do in that the commands are executed from the current shell. 
Trsshell does not display the commands or record them in the history list. 


time 
Displays the current date and time. 


version 


Displays the name of the shell and its current version. 
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This section contains a listing and a summary of all the commands in The System 
Administrator's Guide to XENIX..It also contains some commands available on the 
Core but not mentioned in the manual. 


When using these commands, type boldface text exactly as it appears. Text in 
italics indicates a variable; you substitute something for the italicized text. For 
example, in the command cat filename, you substitute the actual filename for the 
word filename. 


cat concatenate, or display, text on the screen 


cat filename 
displays the contents of the file on the screen 


cd change directory 


cd TE 
returns you to your login directory 


cd directory 
changes your working directory to directory 


chmod change mode 


chmod who operation code permissions file 
changes the permissions mode for file 


who | 
a all (user, group, others) 
g group 
o others 
u user (login owner) 


operation code 


+ add permission 
— remove permission 
= assign all permissions (read, write, and execute) 


permissions 


T read 
W write 
X execute 
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cp copy file 


cp filename? filename2 
_ makes a copy of filename? and names it filename2 


cp filename! filename2 directoryname 
copies 2 files into the specified directory 


date displays the current date and time on the screen 


df disk space free 


df 
displays the number of blocks free on all mounted file systems 


df /dev/hdx 
displays the number of blocks free on the specified disk 


du disk usage 


du directory 
displays the number of blocks in use on the specified directory and in what 
files 


kill terminate a process 


kill number 
terminates the process number 


ìÀc list, or display, the contents of a directory and information on files in that 
directory 


Ic directory name 
displays the contents of the specified directory 


lpr printer spooler 


Ipr filename 
prints the file on the printer 


Is list, or display, the contents of a directory and information on files in that 
directory 


Is directory name 
displays the contents of the directory 


Is -l directory name 
displays the contents of the directory, including the names of all 
subdirectories and files, size, last modification date, and permissions 


mkdir make directory 


mkdir directory name 
makes a directory 


more display text on the screen, 1 screen at a time 


P more filename 
Oi displays the contents of filename on the screen, 1 screen at a time 
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mv move or rename files and directories 


mv filename?! filename2 
changes the name of filename! to filename2 


mv filename! directory name 
moves filename! to the specified directory 


mv directory name new directory name 
changes the name of the specified directory 


passwd change your login password 


park park, or position, the read/write head of the hard drive 


park -on 
positions the read/write head on the last cylinder of the hard disk 


park -off 
positions the read/write head on the cylinder in use 


ps process status 

ps -e 

displays information about all active processes 
pwd print working directory 


pwd 
displays the full pathname of your working directory 


quot summarize file system ownership 


quot -f file system | 
displays the number of blocks and the number of files owned by each user in 
the specified file system 


restore under tsh, restores to hard disk files saved on floppy diskette or disk 
cartridge 


restore drive number -device 
restores files on the diskette or cartridge in Drive n to hard disk 


rm remove files or directories : 


rm filename 
removes the specified file 


rmdir empty directory name 
removes the specified empty directory 


rmuser user name 
removes the specified user 
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save under tsh, save, or back up, files or directories to floppy diskette or cartridge 


save @ -device /usr/name/filename 
copies a file to the specified device in Drive 0 


wall write to all users on the system 


who who is on the system 


who 
displays a list of online users by login name, terminal, and login time 
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accessing. The process of getting at information stored in the computer. 


applications program. A group of instructions that does a specific, practical task, 
such as keeping track of accounts payable. 


backup. A copy of information that is stored in machine-readable form, such as 
floppy diskette or hard disk. 


banner. A heading that separates parts of information printed on the line printer. 
baud rate. The speed at which information is transmitted. 


block. A set of consecutive machine instructions, characters, or digits the 
computer understands as a unit. 


boot. The process of loading the disk operating system. 


buffer. An area of a computer’s memory that is used to store information 
temporarily. 


bulletin board. In the world of computers, an electronic version of the cork type. 
Users exchange information by placing notices on it and responding to posted 
notices. . 


byte. The basic unit of information in the computer. A byte is the equivalent of 1 
character. 


cable. A device consisting of plugs and wiring that lets you manually connect 
computers and peripheral devices. 


Cartridge disk. A platter in a protective enclosure with magnetic material on both 
sides, on which the computer can store data. 


Central Processing Unit. The circuits in the computer that control the execution 
of instructions. 


cleaning. In XENIX terminology, the process of clearing up inconsistencies on the 
file system. 


command. A sequence of characters that tells the computer to take a particular 
action immediately. A command is usually typed at the keyboard. 


communications protocol. The steps you take to get to and converse with 
connected electronic media. 


computer. An electronic device that can receive and follow instructions and then 
use these instructions to calculate and to compile, select, and correlate 
information. It usually consists of a keyboard, a video screen, input/output 
devices, and a Central Processing Unit (CPU). 


console. The host computer in a multiterminal system. See also host computer. 


core system. In XENIX, the basic unit of the operating system that you must have 
to run applications programs. 


CPU. Central Processing Unit. 
current directory. The place in the XENIX system in which you are working. 


cursor. A blinking or steady screen-symbol that indicates the place at which the 
next typed character will appear. 
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cylinder. A division of a hard disk. 
data. Items of information that a computer can process or generate. 


data terminal. A connection between you and a computer that transfers 
information from human form to a format computers understand. It consists of 
3 parts—a keyboard, a videoscreen, and input/output channels. 


default. A condition that exists when you turn on your computer. 


development system. In XENIX, a group of programs and utilities with which you 
can make other programs and do typesetting and printing. It is separate from 
the core system. 


device. Any piece of computer equipment. 


directory. A list of the files on a disk. In XENIX, a disk can have multiple 
directories, each containing other directories and files. 


disable. Disconnect or disallow electronically. 


disk. A device on which a computer can store information. See floppy diskette; 
hard disk. 


diskette. See floppy diskette. 


diskutil. In XENIX, a program with which you format and/or copy hard disks, disk 
cartridges or floppy diskettes. 


display. The video screen. If a program displays text, it shows it on the screen. If 
a program prints text, it prints it on paper at the line printer. 


edit. Alter, or change, text. You edit text when you add, modify, or delete 
portions of it. 


editor. A program that lets you use specific commands to modify text. 
enable. Connect or allow electronically. 


error message. Text that appears on the screen that tells you a mistake has been 
made. It may be your mistake or the computer’s. 


execute permission. In XENIX, a setting that lets you run a program. 


file. A defined unit of data stored on disk. In XENIX, sometimes both files and 
directories are referred to as files. 


file system. The organization and allocation of files on disks. 


floppy diskette. A flexible platter made of a plasticlike material on which the 
computer can store data. 


format. Organize a disk into tracks so that the computer can write on it. 


garbage. A random display of characters that may appear on the screen or in 
printed copy. 


group. In XENIX, a specifically defined collection of users. 


hard disk. A fixed circular metal plate with magnetic material on both sides, on 
which the computer can store data. 


head. A device that reads information from, writes information on, and deletes 
information from a disk. 


hierarchical structure. In XENIX, the way directories and files are organized; that 
is, the way in which they branch from a single root. 
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home directory. In XENIX, your login directory. 
host computer. The controlling computer in a multiterminal computer system. 
initialize. To make a formatted disk ready for use. 


input-output parameters. The electronic options for placing data into a computer 
or taking it out. 


log in. The way in which you identify yourself to the computer. 
login directory. The root directory with which your login name is associated. 
log out. The way in which you tell the computer you are leaving the system. 


manually connected terminal. A computer or data terminal that is connected to 
the host computer by cable. 


media error map. A list of bad, or flawed, tracks and heads that comes with your 
hard disk. | 


megabyte. 1 million bytes. 
menu. A screen display that gives you a list of options. 


modem. A device you connect to your computer and with which you 
communicate with another terminal over telephone lines. 


mount, Make a device electronically or physically accessible to your computer. 


multitasking. The ability of an operating system to perform several tasks at the 
same time. 


multiuser. A computer configuration, or system design, that lets more than 1 
person use the computer at the same time. 


network. A series of interconnected computer communication systems. 


null modem adapter. A device you connect to your computer that tells it you are 
connecting to another computer or data terminal manually. 


operating system. A set of instructions the computer uses to do what you ask it to 
do. For example, the operating system controls the line printer and acts as a 
base for an applications program. 


other. In XENIX, anyone besides a user and a group. 


parameters. Information that defines the options a user supplies when a program 
is run, 


password. A code you supply before the computer lets you use it. 


pathname. In XENIX, the route, or path, the operating system takes to a specific 
file or directory. 


permission. In XENIX, access to files and directories. You may have read, write, 
and/or execute permission. 


permission setting. The code attached to files and directories that determines a 
user's access. 


primary hard disk. The first hard disk you install. In XENIX, the primary disk is 
referred to as hard disk @ (hd@). 


printer. A device for making paper copies of the information produced by a 
computer. 


printing. Making a paper copy of information produced by the computer. 
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process. An operating system’s basic unit of activity. 


program. A set of instructions that tells a computer step by step how to perform a 
task. 


read permission. Lets you display a file on the screen and read it. 
reformat. Reorganize a disk. Reformatting erases existing data. 


remote terminal. A computer or data terminal connected to a computer by 
' modem. 


restore. Put information stored on floppy diskettes back onto a hard disk. 


root. In XENIX, the System Administrator’s login name. Also, the name of a basic 
directory that is required for system operation. 


runaway process. A computer activity that does not stop as the program instructs 
or that you cannot stop manually with ease. 


secondary hard disk. Any hard disk on a system other than the primary hard disk. 
In XENIX, secondary hard disks are identified sequentially as hard disk 1, 
hard disk 2, and so on. 


serial channel. A port on the computer to which you make a modem or cable 
connection. 


shell. A program that reads and interprets what you type at the keyboard. 
shutdown. Closing the system to use. 


spooling. The process by which data is placed in a line, or queue, to await 
transmission. For example, when you print a file on the line printer, the 
computer first places it on a waiting list, or spool, and then in its turn the file 
is printed. 


swap area. The space on the primary hard disk where XENIX temporarily stores 
information on running programs. 


syntax. The form of a command, including the order in which items are placed 
and the way in which they must be stated. 


system administrator. In XENIX, the person responsible for installing, monitoring, 
and maintaining the system. 


terminal. In common usage, a computer or a data terminal. 


text. Anything other than graphics that you type at the keyboard or display on the 
screen. 


UNIX™. An operating system developed by Bell Laboratories and from which 
XENIX is derived. 


unmount, Disconnect or make unavailable for use. 
user. In XENIX, anyone logged in to the system other than root. 


utility. A program, often supplied with an operating system, that performs basic 
system functions such as saving and restoring files and copying files. 


verify. To make certain that a comparison is correct. 

volume. In XENIX, a floppy diskette. 

write permission. Lets you edit a file or directory. 

write-protect. A device or switch that makes it impossible to write on a disk. 


XENIX. A multiuser, multitasking operating system derived from UNIX. 
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index 


| (pipe) 9 

# (root prompt) 15 
$ (last line of file) 52 
$ (user prompt) 22 

* (ed prompt) 51 


+ (add) 36,52 
— (minus) 36, 52 
. (period) 51 


/ (root directory symbol) 30, 76 
= (set) 36 

\ (backslash) 9 

“ (tilde) 9, 64 

300 baud rate 58, 62 

1200 baud rate 58, 62 

9600 baud rate 62 


a (all) 36 

a (appending) 51 

accessing applications programs 24 

accounting information 81 

add (+) 36, 52 

adding file systems 65-68 

adds25 56 

all (a) 36 

appending 51 

applications files, restoring to hard 
disk 29 

applications programs, accessing 24 

applications programs and local 
printing 50 

at command 81 


backing up 25, 38 
disk cartridge 28, 39, 41 
files 28, 38 
floppy diskettes 40 
hard disk 38 
with tar 48 
backslash (\) 9 
16 
backspace key 11, 26 
backup 
daily 38, 39 
disk cartridge 39 
floppy diskettes 38, 40 
full system 38 
periodic 38 
backup library 43 
backup listing 38, 44 
backups, date of the latest 81 
bad tracks 12 
banners 84 
basename 79 
baud rate 58, 62 
Ibin 79 
blocks 36, 66, 69 
allocated to files and users 70 
used by individual directories 70 
Boot Disk 11 
bootup shell script 80 
Bourne Shell 20 
10 
buffer 51 
bulletin board 63 
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C Shell 20 
cable 62 
calling up 
manually connected system 62 
remote system 62 
cartridge, disk 
backing up 28, 39, 41 
formatting 27 
mounting file system 67 
restoring 43 
unmounting a file system 68 
cat 31, 56, 63 
cd 31, 32, 34 
change mode 36 
changing 
directories 30 
drive settings 83 
password for root 16 
permissions 36-37 
system defaults 82 
user password 22 
channel 55, 57 
enabling and disabling 55,57, 62 
Channel A 55, 56, 57 
Channel B 55, 56, 57 
checking a file system 38, 44, 70-71 
chmod 37 
cleaning the hard drive 16 
command directory, XENIX 79 
command interpreter 20 
commands, ending 10 
commands, interrupting 10 
commands, XENIX 94 
comment 19, 21, 22 
communication, initiating and 
terminating 63, 64 
communications protocol 63 
communicating 
with other systems 62 
with users 60 
connecting the DT-1 to the computer 
connecting the DT-100 to the 
computer 55 
console 49, 56, 57 
control sequence 9 
copying a file with cu 64 
core system 47 
cp 33,79 
creating 
directories 31 
files 31 
file structure 80 
file systems on secondary hard 
disks 66 
file with ed 51 
new user password 22 
19 


am 


cu command 62, 63 
current date 17 


d (directory) 37 
daily backup 39, 44 
date 15, 79 
date, current 17 
DB-25 Cable 54 
defaulis 
drive 83 
line printer 84 
mkuser 82 
program 80 
system 82 
terminal 83-84 
deleting 
directory 33 
file 33 
lines from the editing buffer 53 
portion of a line in the editing 
buffer 52 
destructive format 12 
device, null 80-81 
device special directory 79 
device table, mounted 80 
devices, peripheral 80 
/dev 80 
/dev/console 80 
/devicdx 80 
/dev/fdx 80 
/dev/hdx 80 
/dev/lp 80 
/devimem 80 
/dev/null 80 
/dev/root 80 
/devirxx 80 
/dev/iswap 80 
/devitty 80 
/devittyxx 80 


69 
idirectories 30, 79 
changing 31 


removing 33-34 
directories and files, chart 30 
directories for storing files to be 

printed 81 
directory, temporary 80 
disabling 

terminals 56-57 

channels 62 
disk cartridge 

backing up 28, 39, 40, 41 

formatting 27 

mounting file systems 66-68 

restoring 43 

unmounting a file system 68 
disk drives 80 
diskettes 

backing up 40 

double-sided 39, 41, 65 

formatting 26 

single-sided 39, 65 
disk formatter program 79 


index 


disk space 
checking 69 
free 69 
diskutil 11, 13, 26, 27, 40, 41 
/diskutil 79 
displaying 
permission settings 35 
contents of directories 32 
contents of files 32 
contents of the editing buffer 51, 52 
distribution set 14 
double-sided diskettes 39, 41, 65 
drive 83 
drive defaults 83 
drive settings 83 
drives, floppy 83 
drives, mounted 83 
DT-1 50, 83 
connecting to the computer 54 
enabling 55 
setting input-output parameters 54 
DT-100 50,55, 56 
connecting 55 
enabling 56 
installing 56 
parameters 58 
terminal interface 50 
du 70 
dumpdir 79 


echo 79 

ed 35,51-53, 56, 60 

ed prompt (*) 51 

editing buffer 51 
deleting from 52 


enabling 
channel 62 
DT-1 55 
DT-100 56 


ending commands 10 
ENTER 10 


equipment 10 

error messages 81 
/etc 79, 80 
/etc/ddate 81 
/etc/default 80 
/etc/init 80 

/etc/mkfs 80 
/etc/motd 60, 80 
/etc/mount 80 
/etc/miab 80 
/etc/passwd 80 
fetc/rc 67, 80 
/etc/rc.user 67 
letc/sysadmin 45 
/etc/termcap 56, 80 
/etc/ttys 57, 58, 80, 84 
/etc/ttytype 56, 58, 83 
execute permission 35 
exit 29 

expr 79 


file consistency 69 
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File Maintenance Diskette 43 
files 30, 79 

backing up 28, 38 

deleting 33 

log 81 

restoring 43 

transferring 64, 72-75 
file structure 


creating 80 
mounting 80 
root 80 

file system 
adding 65-68 
checking 38, 44, 70-71 
damaged 77 
maintenance 69-71 
mount 66, 67 


unmount 66-68 
File System Check 38, 44, 70-71 
File System Maintenance menu 38, 39, 
44,45 
file systems on cartridge, creating 67-68 
file systems on floppy diskettes, 
creating 65-66 
file systems on secondary hard disks, 
creating 66-67 
filename 28, 31 
floppy diskettes 
backing up 38, 39, 40 
formatting 26 
forgotten root password 16 


format, destructive and nondestructive 12 


formatting cartridges 27 
formatting diskettes 26 

fsck 70, 79 

full system backup 38 

full verify 12 

functions of the XENIX system 71 


g (group) 35, 36 
garbage 58 

group 19, 20 

group (g) 35, 36 
group id number 82 


Hard Disk 1 66 

hard disk, backing up 38, 39, 48 
hard disk warmup 11 

hard drive, cleaning 17 

head 11,12 

header page 84 

home directory 30, 31, 34, 81 


id number 82 
init 80 
initializing your hard disk 13 
initiating Communication 63 
input-output parameters 58 
instal] 24 
Install Disks 11 
installation menu 24 
installing 
applications programs 24 
DT-1 54-55 
DT-100 55-56 
XENIX 11-14 
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interface to corresponding device name, 
unbuffered 80 
interleave factor 12 
Interrupting 
command 10 
program 10 
invisible processes 76 


keyboard 9 
kill 76, 78 


Ic 32, 33, 34 

lc —| 36, 37 

Aib 79 

library files 81 

line printer 80 

line printer daemon 76 

line printer defaults 84 

linefeed 20 

lines, undeleting 53 

local printer 50 

local printing and applications 
programs 50 


log files 81 

logging in 15 

logging out 16 

login 81 

login name 19, 20, 30, 82 
logout 81 


/lost+found 79 

lost screen display 77 
lowercase 9, 31 

lpr 49,50 

Is —| 95 


makefs 65, 66, 67 
manually connected system, calling 
up 62 
Media Error Map 11, 12, 66 
memory, physical 80 
message of the day 60, 80 
messages, error 81 
minus {—) 35,52 
mkdir 31, 66 
mkuser 19, 21 
mkuser defaults 82 
/mnt 66, 67, 79, 80 
modem 57, 58, 59, 62 
monitoring disk space 69 
/motd 60 
/mount 66 
mount directory 79 
mounted drives 83 
mounted secondary hard disk 66 
mounting 
file structure 80 
file system on cartridge 66-68 
file system on floppy diskette 65 
secondary hard disk 66 
moving files 32, 33 
multiuser environment 16, 19, 40, 41 
multiuser system 15 
mv 33,79 


network 63 
no verify 12 


~~ 


nodetect 83 

nondestructive format 12 

normal system shutdown 16 
null device 80-81 

null modem adapter 54, 55 
number of characters in a file 51 


o (other) 35, 36 
office routine 30 
other (o) 35, 36 


p (verify substitute) 52 
parameters, input-output 57-58 
park 18 
partial verify 12 
passwd 15, 22, 79 
password 19 
echo 20 
file 80 
prompt 18 
password for root, changing 16 
pathname 30, 46 
period (.) 51 
periodic backup 38 
peripheral devices 80 
permissions 35-37 
changing 35-36 
PID 71 
pipe 9 
plus (+) 36, 52 
primary hard disk 12 
with 1 floppy drive, restoring 47 
with 2 or more floppy drives, or a 
cartridge, restoring 43 
primary hard disk full 65 
print command 49 
print lines per page 50 
PRINTER 50 
printer 76, 80 


-printer, jammed 76 


printing 49-50 

applications file 49 

file from the console 49 

from a terminal 49-50 

text from ihe console 49 
process ID 71, 78 
process 

killing 78 

monitoring 71 

runaway 77, 78 
processes 

currently running 76 

invisible 76 
profile 36, 82 
program and data file directory, 

additional 79 | 

program and data files, miscellaneous 80 
program defaults 80 
programs, interrupting 10 
program, running 80 


ps 71 
ps —e 71,78 
ps -ef 76 


pushbutton floppy drive 83 


put 64 
pwd 31 


q (quit) 51 
quit (q) 51 
quot 70 


r (read) 35-36 
read permission 35 
reading permission settings 35 
receiving device 63 
receiving messages with cu 63-64 
redirecting unwanted output 80 
reinstalling XENIX 16 
remote system, calling up 63 
remove (—) 36 
removing 
directory 33-34 
file 33 
banners 84 
reset switch 11 
restor 79 
restore 29 
restoring 
applications files to hard disk 29 
entire system of files to hard disk 46 
file 29, 38, 48 
hard disk 37, 38, 43 
primary hard disk with 1 floppy 
drive 47 
primary hard disk with 2 or more 
floppy drives or a cartridge 43 
secondary drive 45 
with tar 48 


RETURN | 10, 20 


root 16 

root directory (/) 79 

root file structure 80 

root password 15, 16 

root password, forgotten 16, 77 
root prompt (#) 15 

RS-232 cable 54,55 

RS-232 jack 54 

runaway process 77,78 


save 28 

screen display, lost 77 

scrolling, starting and stopping 9 
secondary drive, restoring 45 
seekrate 83 

sending and receiving baud rate 62 
sending device 62 

sending messages with cu 63-64 
serial channel 54, 56, 62 


set (=) 35 
setting 
input-output parameters for the 
DT-1 54 


permissions 34-36 
setting up terminals 54-59 
sh 79 


index 
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shell 19, 20 

shell type 20, 22 

shutdown 17, 66, 68 
shutting down the system 16 
single-sided diskettes 41, 65 
sleep 79 

source Cartridge 42 

source diskette 41 

speed 63 

Standard (Bourne) Shell 20 
standard size swap area 13 
structure, XENIX 30 

stty 79 

su 79 

subdirectories 30 
substituting text in the editing buffer 52 
swap area 13, 69, 80 

sync 79 

sysadmin 38 

System Administrator 9 
system console 80 

system date utility 79 
system defaults 82 

system printer 49 

system out of space 77 
system shut down improperly 70 
system spooler 50 


take 64 
tar 48 
temporary directory 79-80 
temporary files 80, 81 
terminal 80 
disabling 56-57 
enabling 55, 56 
terminal capability map 80 
terminal defaults 83, 84 
terminal type 56 
terminating communication 64 
terminator plug 54, 55 
terminal setup 80 
test 79 
thinline floppy drive 83 
tilde () 9, 64 
time 15 
TIME 71 
ftmp 79, 80 
ftmp/backup.list 45 
track 11,12 
tracks, bad 12 
transferring files 64, 72-75 


trs16 56 

tsh 28, 29, 85-93 
TTY 71 

ttiy@1 55-57 
tty@2 56-57 
tyð4 56, 57 
tty05 56, 57 
tty@6 56, 57 
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tx command 72 


u (user) 35, 36 
/Uumount 66, 67, 68 
undeleting lines 53 
Unique id number 82 
unmounting a file system 
automatically 66, 68 
on Cartridge 68 
on floppy diskette 66 
unmounting a secondary hard disk 67 
user 15 
user (u) 35, 36 
user directory 21 
user home directories 21, 79, 81 
user id number 21, 82 
user password 
changing 22 
forgotten 77 
user prompt ($) 22 
/usr 30, 79, 81 
fusr/adm 81 
/usr/adm/messages 81 
/usr/adm/pacct 81 
fusr/adm/wtmp 81 
usr/bin 81 
lusr/lib 81 
/usr/lib/lpd 76 
/usr/name 30, 31 
Jusr/spool 81 
fusr/imp 81 


verify (full, no, partial) 12 
vertical line 9 

Visual Shell 20 

volume 14, 39, 40 


w (write permission) 36 
w (write buffer to a file) 51 
wait 83 

wall 60-61 

wild card character 33 
workspace 30 

write all (wall) 60 
write-enable tab 27 
write permission 35 


x (execute) 36 

/xenix 79 

XENIX 
command directory 79 
commands 79, 81, 94-97 
hierarchical system (chart) 32 
organizational structure 29 
programs 80 

xenix system object code 79 


z80 control program 79 
/z80ct] 79 


